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第 一 章 概述 Introduction 


1.1 MQTT 协 议 的 组 织 结构 Organization of MQTT 


本 规范 分 为 七 个 章节 

e 第 一 章 一 介绍 

。 第 二 章 一 MQTT 控 制 报 文 格式 
。 第 三 章 一 MQTT 控 制 报 文 

e 第 四 章 一 操作 行为 

e@ 第 五 章 一 安全 

e 第 六 章 一 使 用 WebSocket 

e@ 第 七 章 一 一 致 性 目标 


e。 附录 B -强制 性 规范 声明 


1.2 术语 Terminology 


本 规范 中 用 到 的 关键 字 必须 MUST ， 不 能 MUST NOT ， 要求 REQUIRED ; 将 会 SHALL， 不 
会 SHALL NOT ， 应 该 SHOULD， 不 应 该 SHOULD NOT， 推荐 RECOMMENDED ;可 以 
MAY， 可 选 OPTIONAL 都 是 按照 IETF RFC 2119 [RFC2119] 中 的 描述 解释 。 


网 络 连 接 Network Connection 
MQTT 使 用 的 底层 传输 协议 基础 设施 。 


e 客户 端 使 用 它 连 接 服务 端 。 
。 它 提 供 有 序 的 、 可 靠 的 、 双 向 字 节 流传 输 。 


例子 见 4.2 节 。 
应 用 消息 Application Message MQTT 协 议 通 过 网 络 传输 应 用 数据 。 应 用 消息 通过 MQTT 传 
输 时 ， 它 们 有 关联 的 服务 质量 (QoS) 和 主题 (Topic) 。 
客户 端 Client 
使 用 MQTT 的 程序 或 设备 。 客 户 端 总 是 通过 网 络 连接 到 服务 端 。 它 可 以 
e 发 布 应 用 消息 给 其 它 相关 的 客户 端 。 
。 订阅 以 请 求 接受 相关 的 应 用 消息 。 
。 Ty 阅 ma 用 消息 的 请 求 。 


服务 端 Server 
一 个 程序 或 设备 ， 作 为 发 送 消 息 的 客户 端 和 请 求 订 阅 的 客户 端 之 间 的 中 介 。 服 务 端 


e。 接受 来 自 客户 端的 网 络 连 接 。 

。 接受 客户 端 发 布 的 应 用 消息 。 

e。 处 理 客户 端的 订阅 和 取消 订阅 请 求 。 

e 转发 应 用 消息 给 符合 条 件 的 已 订阅 客户 端 。 


订阅 Subscription 
订阅 包含 一 个 主题 过 滤器 (Topic Filter) 和 一 个 最 大 的 服务 质量 (QoS) 等 级 。 订 阅 与 单个 会 
话 (Session) 关联 。 会 话 可 以 包含 多 于 一 个 的 订阅 。 会 话 的 每 个 订阅 都 有 一 个 不 同 的 主题 过 


> 虑 B42 
滤器 。 


主题 名 Topic Name 
附加 在 应 用 消息 上 的 一 个 标签 ， 服 务 端 已 知 且 与 订阅 匹配 。 服 务 端 发 送 应 用 消息 的 一 个 副本 
给 每 一 个 匹配 的 客户 端 订阅 。 


主题 过 滤器 Topic Filter 
订阅 中 包含 的 一 个 表达 式 ， 用 于 表示 相关 的 一 个 或 多 个 主题 。 主 题 过 滤器 可 以 使 用 通配符 。 


会 话 Session 
客户 端 和 服务 端 之 间 的 状态 交互 。 一 些 会 话 持 续 时 长 与 网 络 连接 一 样 ， 另 一 些 可 以 在 客户 端 
和 服务 端的 多 个 连续 网 络 连 接 间 扩展 。 


控制 报 文 MQTT Control Packet 
通过 网 络 连 接 发 送 的 信息 数据 包 。MQTT 规 范 定义 了 十 四 种 不 同类 型 的 控制 报 文 ， 其 中 一 个 
(PUBLISH 报 文 ) 用 于 传输 应 用 消息 。 


1.5 数据 表示 Data representations 
1.5.1 二 进 制 位 Bits 

字 节 中 的 位 从 0 到 7。 第 7 位 是 最 高 有 效 位 ， 第 0 位 是 最 低 有 效 位 。 
1.5.2 整数 数值 Integer data values 


整数 数值 是 16 位 ， 使 用 大 端 序 (big-endian， 高 位 字 节 在 低位 字 节 前 面 ) 。 这 意味 着 一 个 16 位 
的 字 在 网 络 上 表示 为 最 高 有 效 字 节 (MSB) ， 后 面 跟着 最 低 有 效 字 节 (LSB) 。 


1.5.3 UTF-8 编 码 字符 串 UTF-8 encoded strings 


后 面 会 描述 的 控制 报 文 中 的 文本 字段 编码 为 UTF-8 格 式 的 字符 串 。UTF-8 [RFC3629] 是 一 个 
高 效 的 Unicode 字 符 编码 格式 ， 为 了 支持 基于 文本 的 通信 ， 它 对 ASCII 字 符 的 编码 做 了 优化 。 


每 一 个 字符 串 都 有 一 个 两 字 节 的 长 度 字 段 作为 前 级 ， 它 给 出 这 个 字符 串 UTF-8 编 码 的 字 节 数 ， 
它们 在 图 例 1.1UTF-8 编 码 字 符 串 的 结构 中 描述 。 因 此 可 以 传送 的 UTF-8 编 码 的 字符 串 大 小 有 
一 个 限制 ， 不 能 超过 65535 字 节 。 


除非 另 有 说 明 ， 所 有 的 UTF-8 编 码 字 符 串 的 长 度 都 必须 在 0 到 65535 字 节 这 个 范围 内 。 


图 例 1.1 UTF-8 编 码 字 符 串 的 结构 Structure of UTF-8 encoded strings 


二 进 制 位 7-0 
byte 1 字符 串 长 度 的 最 高 有 效 字 节 (MSB) 
byte 2 字符 串 长 度 的 最 低 有 效 字 节 (LSB) 
byte 3 .… 如 果 长 度 大 于 0， 这 里 是 UTF-8 编 码 的 字符 数据 。 


UTF-8 编 码 字符 串 中 的 字符 数据 必须 是 按照 Unicode 规 范 [Unicode] 定义 的 和 在 RFC3629 
[RFC3629] 中 重申 的 有 效 的 UTF-8 格 式 。 特 别 需 要 指出 的 是 ， 这 些 数据 不 能 包含 字符 码 在 
U+D800 和 U+DFFF 之 间 的 数据 。 如 果 服 务 端 或 客户 端 收 到 了 一 个 包含 无 效 UTF-8 字 符 的 控制 
报 文 ， 它 必须 关闭 网 络 连接 [MQTT-1.5.3-1]。 


UTF-8 编 码 的 字符 串 不 能 包含 空 字符 U+0000。 如 果 客 户 端 或 服务 端 收 到 了 一 个 包含 Uf0000 的 
控制 报 文 ， 它 必须 关闭 网 络 连接 [MQTT-1.5.3-2] 。 


数据 中 不 应 该 包含 下 面 这 些 Unicode 代 码 点 的 编码 。 如 果 一 个 接收 者 (服务 端 或 客户 端 ) 收 到 
了 包含 下 列 任 意 字 符 的 控制 报 文 ， 它 可 以 关闭 网 络 连接 : 


U+0001 和 U+001F 之 间 的 控制 字符 

U+007F 和 U+009F 之 间 的 控制 字符 
Unicode 规 范 定义 的 非 字 符 代码 点 (例如 U+OFFFF) 
。 Unicode 规 范 定义 的 保留 字符 (例如 U+OFFFF) 


UTF-8 编 码 序 列 0XEF 0xBB 0xBF 总 是 被 解释 为 U+FEFF ( 零 宽度 非 换 行 空白 字符 ) ,无论 它 
出 现在 字符 串 的 什么 位 置 ， 报 文 接收 者 都 不 能 跳 过 或 者 剥离 它 [MQTT-1.5.3-3] 。 


非 规 范 示例 Non normative example 


例如 ， 字 符 串 A 是 一 个 拉丁 字母 A 后 面 跟着 一 个 代码 点 U+2A6D4( 它 表示 一 个 中 日 韩 统 
一 表意 文字 扩展 B 中 的 字符 )， 这 个 字符 串 编码 如 下 : 


图 例 1.2 UTF-8 编 码 字符 串 非 规范 示例 UTF-8 encoded string non normative example 


Bit 7 6 5 4 3 2 1 
byte 1 字符 串 长 度 MSB (0x00) 
0 


符 串 长 度 LSB (0x05) 


byte 2 字 

0 0 0 0 0 1 0 
A 

0 


byte 3 (Ox41) 
byte 4 (OxFO) 


byte 5 (OxAA) 


byte 6 (Ox9B) 


1 C0 
byte 7 (0x94) 
1 0 10 11 10 |11 10 


1.6 编辑 约定 Editing conventions 


本 规范 用 黄色 高 亮 的 文本 标识 一 致 性 声明 ， 每 个 一 致 性 声明 都 分 配 了 一 个 这 种 格式 的 引用 : 
[MQTT-x.x.x-y] 。 
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2.1 MQTT 控 制 报 文 的 结构 Structure of an MQTT 


Control Packet 


MQTT 协 议 通 过 交换 预定 义 的 MQTT 控 制 报 文 来 通信 。 这 一 节 描 述 这 些 报 文 的 格式 。 


MQTT 控 制 报 文 由 三 部 分 组 成 ， 按 照 图 例 2.1 一 MQTT 控 制 报 文 的 结构 描述 的 顺序 : 


图 例 2.1 一 MQTT 控 制 报 文 的 结构 


Fixed header 固定 报头 ， 所 有 控制 报 文 都 包 
Variable header 可 变 报头 ， 部 分 控制 报 文 包含 
Payload 有 效 载荷 ， 部 分 控制 报 文 包含 


2.2 固定 报头 Fixed header 


每 个 MQTT 控 制 报 文 都 包含 一 个 固定 报头 。 图 例 2.2 -固定 报头 的 格式 描述 了 固定 报头 的 格 


式 。 


图 例 2.2 -固定 报头 的 格式 


Bit 
byte 1 
byte 2... 


2.1 MQTT 控 制 报 文 的 类 


7 


6 


5 4 


MQTT 控 制 报 文 的 类 型 


位 置 : 第 1 个 字 节 ， 二 进 制 位 7-4。 
表示 为 4 位 无 符号 值 ， 这 些 值 的 定 


表格 2.1 -控制 报 文 的 类 型 


名 字 
Reserved 
CONNECT 
CONNACK 
PUBLISH 
PUBACK 
PUBREC 
PUBREL 
PUBCOMP 
SUBSCRIBE 
SUBACK 


UNSUBSCRIBE 


UNSUBACK 
PINGREQ 
PINGRESP 
DISCONNECT 


Reserved 


值 


中 © Nm 9 上 wm mm 


= | a | a 
人 玉 中 ND 一 OO 


15 


2.2.2 标志 Flags 


国定 报头 第 1 个 字 节 


的 详细 信息 见 


的 剩余 的 4 位 [3-0] 包 含 每 个 MQTT 控 制 报 文 类 
标志 位 。 表 格 2.2 中 任何 标记 为 “保留 "的 标志 
列 出 的 值 [MQTT-2.2.2-1] 。 
4.8 节 [MQTT-2.2.2-2] 。 


报 文 流动 方向 
禁止 

客户 端 到 服务 端 
服务 端 到 客户 端 
两 个 方向 都 允许 
两 个 方向 都 允许 
两 个 方向 都 允许 
两 个 方向 都 允许 
两 个 方向 都 允许 
客户 端 到 服务 端 





服务 端 到 客户 端 
客户 端 到 服务 端 


服务 端 到 客户 端 


位 ， 都 是 保留 给 
如 果 收 到 非法 的 标志 


3 2 
用 于 指定 控制 报 文 类 
剩余 长 度 


见 表格 2.1 -控制 报 文 的 类 型 


保留 

客户 端 请 求 连接 服务 
连接 报 文 确认 
发 布 消息 


QoS 1 消息 发 布 收 到 确认 
发 布 收 到 (保证 交付 第 一 


1 


型 的 标 ， 


步 ) 


发 布 释放 (保证 交付 第 二 步 ) 
QoS 2 消息 发 布 完成 (保证 交互 第 三 步 ) 


客户 端 订 阅 请 求 


订阅 请 求 报 文 确认 


客户 端 取消 订阅 请 求 


取消 订阅 报 文 确认 


心跳 请 求 

心跳 响应 
客户 端 断 开 连接 
保留 


型 特定 的 标志 ， 
以 后 使 用 的 ， 必 须 设置 为 表格 中 


志 位 


型 MQTT Control Packet type 


见 表格 2.2 - 


， 接收 者 必须 关闭 网 络 连接 。 有 关 错 误 处 理 


表格 2.2 - 标志 位 Flag Bits 


控制 报 文 定 报头 标志 Bit 3 Bit 2 Bit 1 Bit 0 
CONNECT Reserved 0 0 0 0 
CONNACK Reserved 0 0 0 0 
PUBLISH Usedin MQTT3.1.1 ，DUP1 Qos? Qos? RETAIN’ 
PUBACK Reserved 0 0 0 0 
PUBREC Reserved 0 0 0 0 
PUBREL Reserved 0 0 1 0 
PUBCOMP Reserved 0 0 0 0 
SUBSCRIBE Reserved 0 0 1 0 
SUBACK Reserved 0 0 0 0 
UNSUBSCRIBE Reserved 0 0 1 0 
UNSUBACK Reserved 0 0 0 0 
PINGREQ Reserved 0 0 0 0 
PINGRESP Reserved 0 0 0 0 
DISCONNECT Reserved 0 0 0 0 


。 DUP1 = 控制 报 文 的 重复 分 发 标志 
。 QoS2 = PUBLISH 报 文 的 服务 质量 等 级 
e@ RETAIN3 = PUBLISH 报 文 的 保留 标志 


PUBLISH 控 制 报 文中 的 DUP, QoS 和 RETAIN 标 志 的 描述 见 3.3.1 节 。 


2.2.3 剩余 长 度 Remaining Length 
位 置 : 从 第 2 个 字 节 开始 。 


剩余 长 度 (Remaining Length ) 表示 当前 报 文 剩余 部 分 的 字 节 数 ， 包 括 可 变 报 头 和 负载 的 数 
据 。 剩 余 长 度 不 包括 用 于 编码 剩余 长 度 字段 本 身 的 字 节 数 。 


剩余 长 度 字 段 使 用 一 个 变 长 度 编码 方案 ， 对 小 于 128 的 值 它 使 用 单字 节 编 码 。 更 大 的 值 按 下 面 
的 方式 处 理 。 低 7 位 有 效 位 用 于 编码 数据 ， 最 高 有 效 位 用 于 指示 是 否 有 更 多 的 字 节 。 因 此 每 个 
字 节 可 以 编码 128 个 数值 和 一 个 延续 位 (continuation bit) 。 剩 余 长 度 字 段 最 大 4 个 字 节 。 


非 规范 评注 


例如 ， 十 进 制 数 64 会 被 编码 为 一 个 字 节 ， 数 值 是 64， 有 制 表 示 为 0x40,。 十 进 制 数 字 


321(=65+2* 128) 被 编码 为 两 个 字 节 ， 最 低 有 效 位 在 前 。 第 一 个 字 节 是 65+128=193。 注 
意 最 高 位 为 1 表示 后 面 至 少 还 有 一 个 字 节 。 第 二 个 字 节 是 2 。 
非 规 范 评注 


这 允许 应 用 发 送 最 大 256MB(268,435,455) 大 小 的 控制 报 文 。 这 个 数值 在 报 文中 的 表示 
是 : 0xFF,OxFF,OxFF,Ox7F 。 


表格 2.4 剩 余 长 度 字段 的 大 小 展示 了 剩余 长 度 字段 所 表示 的 值 随 字 节 增 长 。 


表格 2.4 剩 余 长 度 字 段 的 大 小 Size of Remaining Length field 


字 节 数 最 小 值 最 大 值 

1 0 (0x00) 127 (Ox7F) 

2 128 (0x80, 0x01) 16 383 (OxFF, 0x7F) 

3 16 384 (0x80, 0x80, 0x01) 2 097 151 (OxFF, OxFF, Ox7F) 

4 2 097 152 (0x80, 0x80, 0x80, 0x01) 268 435 455 (OxFF, OxFF, OxFF, Ox7F) 


分 别 表示 (每 个 字 节 的 低 7 位 用 于 编码 数据 ， 最 高 位 是 标志 位 ) 


。 1 个 字 节 时 ， 从 0(0x00) 到 127(0x71) 

。 2 个 字 节 时 ， 从 128(0x80,0x01) 到 16383(OXff,0x7f) 

。 3 个 字 节 时 ， 从 16384(0x80,0x80,0x01) 到 2097151(0xFF,OxFF,0x7F) 

。 4 个 字 节 时 ， 从 2097152(0x80,0x80,0x80,0x01) 到 268435455(0xFF,0xFF,0xFF,0x7F) 


非 规范 评注 
非 负 整数 X 使 用 变 长 编码 方案 的 算法 如 下 : 


do 
encodedByte = X MOD 128 
XK =X DUIVel28 
// if there are more data to encode, set the top bit of this byte 
(0 
encodedByte = encodedByte OR 128 
endif 
'output' encodedByte 
while ( Xx>0) 


MOD 是 模 运 算 ，DIV 是 整数 除法 ，OR 是 位 操作 或 (C 语 言 中 分 别 是 %，/，|) 


非 规范 评注 


剩余 长 度 字 段 的 解码 算法 如 下 : 


multiplier = 1 
value = 0 
do 
encodedByte = 'next byte from stream' 
value += (encodedByte AND 127) * multiplier 
multiplier *= 128 
Tf (motile 8 26128) 
throw Error(Malformed Remaining Length) 
while ((encodedByte AND 128) != 0) 


AND 是 位 操作 与 (C 语 言 中 的 &) 

这 个 算法 终止 时 ，value 包 含 的 就 是 剩余 长 度 的 值 。 
2.3 可 变 报头 Variable header 
某 些 MQTT 控 制 报 文 包含 一 个 可 变 报头 部 分 。 它 在 固定 报头 和 负载 之 间 。 可 变 报 头 的 内 容 根据 
报 文 类 型 的 不 同 而 不 同 。 可 变 报头 的 报 文 标识 符 (Packet ldentifier) 字段 存在 于 在 多 个 类 型 


的 报 文 里 。 


2.3.1 报 文 标识 符 Packet Identifier 


图 例 2.3 - 报 文 标识 符 字 节 Packet Identifier bytes 


Bit 7-0 
byte 1 报 文 标识 符 MSB 
byte 2 报 文 标识 符 LSB 


很 多 控制 报 文 的 可 变 报头 部 分 包含 一 个 两 字 节 的 报 文 标识 符 字 段 。 这 些 报 文 是 
PUBLISH (QoS > 0 时 ) ，PUBACK，PUBREC，PUBREL，PUBCOMP，SUBSCRIBE， 
SUBACK ， UNSUBSCIBE ; UNSUBACK 。 


SUBSCRIBE ， UNSUBSCRIBE 和 PUBLISH (QoS 大 于 0) 控制 报 文 必须 包含 一 个 非 零 的 16 
位 报 文 标识 符 (Packet ldentifier) [MQTT-2.3.1-1]。 客 户 端 每 次 发 送 一 个 新 的 这 些 类 型 的 报 文 
时 都 必须 分 配 一 个 当前 未 使 用 的 报 文 标识 符 [MQTT-2.3.1-2]。 如 果 一 个 客户 端 要 重 发 这 个 特 
殊 的 控制 报 文 ， 在 随后 重 发 那个 报 文 时 ， 它 必须 使 用 相同 的 标识 符 。 当 客户 端 处 理 完 这 个 报 
文 对 应 的 确认 后 ， 这 个 报 文 标识 符 就 释放 可 重用 。QoS 1 的 PUBLISH 对 应 的 是 PUBACK ， 
QoS 2 的 PUBLISH 对 应 的 是 PUBCOMP， 与 SUBSCRIBE 或 UNSUBSCRIBE 对 应 的 分 别 是 
SUBACK 或 UNSUBACK [MQTT-2.3.1-3]。 发 送 一 个 QoS 0 的 PUBLISH 报 文 时 ， 相 同 的 条 件 也 
适用 于 服务 端 [MQTT-2.3.1-4] 。 


QoS 等 于 0 的 PUBLISH 报 文 不 能 包含 报 文 标识 符 [MQTT-2.3.1-5] 。 


PUBACK, PUBREC, PUBREL 报 文 必须 包含 与 最 初 发 送 的 PUBLISH 报 文 相同 的 报 文 标识 符 
[MQTT-2.3.1-6]。 类 似 地 ，SUBACK 和 UNSUBACK 必 须 包 含 在 对 应 的 SUBSCRIBE 和 
UNSUBSCRIBE 报 文中 使 用 的 报 文 标识 符 [MQTT-2.3.1-7] 。 


需要 报 文 标识 符 的 控制 报 文 在 表格 2.5 -包含 报 文 标识 符 的 控制 报 文 中 列 出 。 


表格 2.5 -包含 报 文 标识 符 的 控制 报 文 Control Packets that contain a Packet Identifier 


控制 报 文 报 文 标识 符 字段 


CONNECT 不 需要 
CONNACK 不 需要 
PUBLISH 需要 (如 果 QoS > 0) 
PUBACK 需要 
PUBREC 需要 
PUBREL 需要 
PUBCOMP 需要 
SUBSCRIBE 需要 
SUBACK 需要 
UNSUBSCRIBE 需要 
UNSUBACK 需要 
PINGREQ 不 需要 
PINGRESP 不 需要 
DISCONNECT 不 需要 


客户 端 和 服务 端 彼 此 独立 地 分 配 报 文 标识 符 。 因 此 ， 客 户 端 服务 端 组 合 使 用 相同 的 报 文 标识 
符 可 以 实现 并 发 的 消息 交换 。 


非 规范 评注 


客户 端 发 送 标识 符 为 0x1234 的 PUBLISH 报 文 ， 它 有 可 能 会 在 收 到 那个 报 文 的 PUBACK 之 前 ， 
先 收 到 服务 端 发 送 的 另 一 个 不 同 的 但 是 报 文 标识 符 也 为 0x1234 的 PUBLISH 报 文 。 


Client Server 
PUBLISH Packet Identifier=0x1234--- 
--PUBLISH Packet Identifier=0x1234 
PUBACK Packet Identifier=0x1234--- 
--PUBACK Packet Identifier=0x1234 


2.4 有 效 载 荷 Payload 


某 些 MQTT 控 制 报 文 在 报 文 的 最 后 部 分 包含 一 个 有 效 载荷 ， 这 将 在 第 三 章 论 述 。 对 于 
PUBLISH 来 说 有 效 载荷 就 是 应 用 消息 。 表 格 2.6 一 包含 有 效 载 荷 的 控制 报 文 列 出 了 需要 有 效 
载荷 的 控制 报 文 。 


表格 2.6 - 包含 有 效 载荷 的 控制 报 文 Control Packets that contain a Payload 


控制 报 文 有 效 载荷 
CONNECT 需要 
CONNACK 不 需要 
PUBLISH 可 选 
PUBACK 不 需要 
PUBREC 不 需要 
PUBREL 不 需要 
PUBCOMP 不 需要 
SUBSCRIBE 需要 
SUBACK 需要 
UNSUBSCRIBE 需要 
UNSUBACK 不 需要 
PINGREQ 不 需要 
PINGRESP 不 需要 
DISCONNECT 不 需要 
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3.1 CONNECT -- 连接 服务 端 


罕 六 端 到 服务 说 的 网 络 寻 车 接 建立 后 ， 客 户 端 发 送 给 服务 端的 第 一 个 报 文 必须 是 CONNECT 报 
文 [MQTT-3.1.0-1]。 

在 一 个 网 络 连 接 上 ， 客 户 端 只 能 发 送 一 次 CONNECT 报 文 。 服 务 端 必须 将 客户 端 发 送 的 第 二 

IE 规 处 理 并 断 开 客户 端的 连接 [MQTT-3.1.0-2]。 有 关 错 误 处 理 的 
息 请 查看 4.8 节 。 


有 效 载荷 包含 一 个 或 多 个 编码 的 字段 。 和 包括 客户 端的 唯一 标识 符 ，Wil 主 题 ，Wil 消 息 ， 用 户 
名 和 密码 。 除 了 客户 端 标识 之 外 ， 其 它 的 字段 都 是 可 选 的 ， 基 于 标志 位 来 决定 可 变 报头 中 是 
否 需 要 和 包含 这 些 字段 。 


3.1.1 固定 报关 Fixed header 


图 例 3.1 -CONNECT 报 文 的 国定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 报 文 类 型 (1) Reserved 保留 位 
0 0 0 1 0 0 0 0 
byte 2 剩余 长 度 


剩余 长 度 等 于 可 变 报头 的 长 度 〈《10 字 节 ) 加 上 有 效 载 荷 的 长 度 。 编 码 方式 见 2.2.3 节 的 说 明 。 


3.1.2 可 交 报 头 Variable header 


CONNECT 报 文 的 可 变 报 头 按 下 列 次 序 包含 四 个 字段 : 协议 名 (Protocol Name ) ， 协 议 级 别 
(Protocol Level) ， 连 接 标志 (Connect Flags) 和 保持 连接 (Keep Alive) 。 


协议 名 Protocol Name 


图 例 3.2 -协议 名 字 节 构成 


协议 名 

byte 1 长 度 MSB (0) 0 0 0 0 0 0 0 0 
byte 2 长 度 LSB (4) 0 0 0 0 0 1 0 0 
byte 3 'M' 0 1 0 0 1 1 0 1 
byte 4 ‘Q 0 1 0 1 0 0 0 1 
byte 5 并 0 1 0 1 0 1 0 0 
byte 6 下 0 1 0 1 0 1 0 0 


协议 名 是 表示 协议 名 MQTT 的 UTF-8 编 码 的 字符 串 。MQTT 规 范 的 后 续 版 本 不 会 改变 这 个 字 
符 串 的 偏 移 和 长 度 。 


它 规 范 继续 卖 处 理 


如 果 协 议 名 不 正确 服务 端 可 以 断 开 客户 端的 连接 ， 也 可 以 按照 某 些 其 
EE 继续 处 理 CONNECT 报 文 


CONNECT 报 文 。 对 于 后 一 种 情况 ， 按 照 本 规范 ， 服 务 端 不 
[MQTT-3.1.2-1] 。 


非 规 范 评注 


数据 包 检 测 工具 ， 例 如 防火 墙 ， 可 以 使 用 协议 名 来 识别 MQTT 流 量 。 


协议 级 别 Protocol Level 


图 例 3.3 - Protocol Level byte 协 议 级 别 字 节 构 成 


说 明 7 6 5 4 3 2 1 0 
协议 级 别 
byte 7 Level(4) 0 0 0 0 0 1 0 0 


客户 端 用 8 位 的 无 符号 值 表示 协议 的 修订 版 本 。 对 于 3.1.1 版 协议 ， 协 议 级 别 字段 的 值 是 
4(0x04) 。 如 果 发 现 不 支持 的 协议 级 别 ， 服 务 端 必须 给 发 送 一 个 返回 码 为 0x01 (不 支持 的 协议 
级 别 ) 的 CONNACK 报 文 响应 CONNECT 报 文 ， 然 后 断 开 客 户 端的 连接 [MQTT-3.1.2-2] 。 


连接 标志 Connect Flags 


连接 标志 字 节 包含 一 些 用 于 指定 MQTT 连 接 行为 的 参数 。 它 还 指出 有 效 载荷 中 的 字段 是 否 存 
在 0° 


图 例 3.4 -连接 标志 位 


Ca 7 | ss sa 1 


User Name Password | Will Retain Will QoS Will Flag Clean Reserved 
Flag Flag Session 





wes | x | x | x TxTx|*x|x|o 
服务 端 必须 验证 CONNECT 控 制 报 文 的 保留 标志 位 (第 0 位 ) 是 否 为 0， 如 果 不 为 0 必须 断 开 窜 


户 端 连接 [MQTT-3.1.2-3] 。 


清理 会 话 Clean Session 


电 


位 


了 部 


: 连接 标志 字 节 的 第 1 位 
这 个 二 进 制 位 指定 了 会 话 状态 的 处 理 方式 。 


客户 端 和 服务 端 可 以 保存 会 话 状态 ， 以 支持 跨 网 络 连接 的 可 靠 消息 传输 。 这 个 标志 位 用 于 控 
制 会 话 状态 的 生存 时 间 。 


如 果 清 理会 话 (CleanSession) 标志 被 设置 为 0， 服 务 端 必 须 基 于 当前 会 话 〈 使 用 客户 端 标识 
符 识别 ) 的 状态 恢复 与 客户 端的 通信 。 如 果 没 有 与 这 个 客户 端 标识 符 关 联 的 会 话 ， 服 务 端 必 
须 创 建 一 个 新 的 会 话 。 在 连接 断 开 之 后 ， 当 连接 断 开 后 ， 客 户 端 和 服务 端 必 须 保存 会 话 信 息 
[MQTT-3.1.2-4]。 当 清理 会 话 标志 为 0 的 会 话 连接 断 开 之 后 ， 服 务 端 必 须 将 之 后 的 QoS 1 和 
QoS 2 级 别 的 消息 保存 为 会 话 状 态 的 一 部 分 ， 如 果 这 些 消息 匹配 断 开 连接 时 客户 端的 任何 订阅 
[MQTT-3.1.2-5]。 服务 端 也 可 以 保存 满足 相同 条 件 的 QoS 0 级 别 的 消息 。 

如 果 清 理会 话 (CleanSession) 标志 被 设置 为 1， 客 户 端 和 服务 端 必须 丢弃 之 前 的 任何 会 话 并 
开始 一 个 新 的 会 话 。 会 话 仅 持续 和 网 络 连接 同样 长 的 时 间 。 与 这 个 会 话 关联 的 状态 数据 不 能 
被 任何 之 后 的 会 话 重 用 [MQTT-3.1.2-6] 。 

客户 端的 会 话 状态 包括 : 

。 已 经 发 送 给 服务 端 但 是 还 没有 完成 确认 的 QoS 1 和 QoS 2 级 别 的 消息 

。 已 从 服务 端 接收 ， 但 是 还 没有 完成 确认 的 QoS 2 级 别 的 消息 。 

服务 端的 会 话 状态 包括 : 

。 会 话 是 否 存 在 ， 即 使 会 话 状态 的 其 它 部 分 都 是 空 。 

。 客户 端的 订阅 信息 。 

e 已 经 发 送 给 客户 端 ， 但 是 还 没有 完成 确认 的 QoS 1 和 QoS 2 级 别 的 消息 。 

e。 即将 传输 给 客户 端的 QoS 1 和 QoS 2 级 别 的 消息 。 

e 已 从 客户 端 接收 ， 但 是 还 没有 完成 确认 的 QoS 2 级 别 的 消息 。 

e 可 选 ， 准 备 发 送 给 客户 端的 QoS 0 级 别 的 消息 。 

保留 消息 不 是 服务 端 会 话 状态 的 一 部 分 ， 会 话 终止 时 不 能 删除 保留 消息 [MQTT-3.1.2.7] 。 


有 关 状 态 存储 的 限制 和 细节 见 第 4.1 节 。 


当 清 理会 话 标志 被 设置 为 1 时 ， 客 户 端 和 服务 端的 状态 删除 不 需要 是 原子 操作 。 
非 规 范 评注 
为 了 确保 在 发 生 故 障 时 状态 的 一 致 性 ， 客 户 端 应 该 使 用 会 话 状态 标志 1 重复 请 求 连接 ， 直 
到 连接 成 功 。 
非 规 范 评注 
一 般 来 说 ， 客 户 端 连 接 时 总 是 将 清理 会 话 标志 设置 为 0 或 1， 并 且 不 交替 使 用 两 种 值 。 这 
个 选择 取决 于 具体 的 应 用 。 清 理会 话 标志 设置 为 1 的 客户 端 不 会 收 到 日 的 应 用 消息 ， 而 且 
在 每 次 连接 成 功 后 都 需要 重新 订阅 任何 相关 的 主题 。 清 理会 话 标志 设置 为 0 的 客户 端 会 收 
到 所 有 在 它 连接 断 开 期 间 发 布 的 QoS 1 和 QoS 2 级 别 的 消息 。 因 此 ， 要 确保 不 丢失 连接 断 
开 期 间 的 消息 ， 需 要 使 用 QoS 1 或 QoS 2 级 别 ， 同 时 将 清理 会 话 标志 设置 为 0。 
非 规 范 评注 
清理 会 话 标志 0 的 客户 端 连接 时 ， 它 请 求 服务 端 在 连接 断 开 后 保留 它 的 MQTT 会 话 状 态 。 
如 果 打 算 在 之 后 的 某 个 时 间 点 重 连 到 这 个 服务 端 ， 客 户 端 连接 应 该 只 使 用 清理 会 话 标志 
0。 当 客户 端 决定 之 后 不 再 使 用 这 个 会 话 时 ， 应 该 将 清理 会 话 标志 设置 为 1 最 后 再 连接 一 
次 ， 然 后 断 开 连接 。 


遗嘱 标志 Will Flag 


位 置 : 连接 标志 的 第 2 位 。 


遗嘱 标志 (Will Flag) 被 设置 为 1， 表 示 如 果 和 连接 请 求 被 接受 了 ， 遗 路 (Will Message) 消息 
必须 被 存储 在 服务 端 并 且 与 这 个 网 络 连接 关联 。 之 后 网 络 连 接 关闭 时 ， 服 务 端 必 须发 布 这 个 
遗嘱 消息 ， 除 非 服务 端 收 到 DISCONNECT 报 文 时 删除 了 这 个 遗嘱 消息 [MQTT-3.1.2-8] 。 


遗嘱 消息 发 布 的 条 件 ， 包 括 但 不 限于 : 


e。 服务 端 检测 到 了 一 个 MO 错误 或 者 网 络 故障 。 

e。 客户 端 在 保持 连接 (Keep Alive) 的 时 间 内 未 能 通讯 。 

。 客户 端 没 有 先 发 送 DISCONNECT 报 文 直接 关闭 了 网 络 连 接 。 
e。 由 于 协议 错误 服务 端 关 闭 了 网 络 连接 。 


如 果 遗 嘱 标 志 被 设置 为 1， 连 接 标 志 中 的 Will QoS 和 Wil Retain 字 段 会 被 服务 端 用 到 ， 同 时 有 
效 载 荷 中 必须 包含 Will Topic 和 Will Message 字 段 [MQTT-3.1.2-9] 。 


一 旦 被 发 布 或 者 服务 端 收 到 了 客户 端 发 送 的 DISCONNECT 报 文 ， 遗 路 消 息 就 必须 从 存储 的 会 
话 状态 中 移 除 [MQTT-3.1.2-10] 。 


如 果 遗 嘱 标 志 被 设置 为 0， 连 接 标志 中 的 Will QoS 和 Will Retain 字 段 必 须 设置 为 0， 并 且 有 效 载 
荷 中 不 能 包含 Will Topic 和 Will Message 字 段 [MQTT-3.1.2-11] 。 


如 果 遗 嘱 标 志 被 设置 为 0， 网 络 连接 断 开 时 ， 不 能 发 送 遗 嘱 消 息 [MQTT-3.1.2-12] 。 


服务 端 应 该 迅速 发 布 遗 嘱 消 息 。 在 关机 或 故障 的 情况 下 ， 服 务 端 可 以 推迟 遗嘱 消息 的 发 布 直 
到 之 后 的 重启 。 如 果 发 生 了 这 种 情况 ， 在 服务 器 故障 和 遗嘱 消息 被 发 布 之 间 可 能 会 有 一 个 延 
店 嘱 QoS Will QoS 

位 置 : 连接 标志 的 第 4 和 第 3 位 。 


这 两 位 用 于 指定 发 布 遗 嘱 消 息 时 使 用 的 服务 质量 等 级 。 


如 果 遗 嘱 标 志 被 设置 为 0， 遗 嘱 QoS 也 必须 设置 为 0(0x00) [MQTT-3.1.2-13] 。 
如 果 遗 嘱 标志 被 设置 为 1， 遗 嘱 QoS 的 值 可 以 等 于 0(0x00)，1(Ox01)，2(O0x02)。 它 的 值 不 能 等 


于 3 [MQTT-3.1.2-14] 。 


遗嘱 保留 Will Retain 

位 置 : 连接 标志 的 第 5 位 。 

如 果 遗 嘱 消 息 被 发 布 时 需要 保留 ， 需 要 指定 这 一 位 的 值 。 

如 果 遗 唱 标 志 被 设置 为 0， 遗嘱 保留 (Will Retain) 标志 也 必须 设置 为 0 [MQTT-3.1.2-15] 。 
如 果 遗 嘱 标 志 被 设置 为 1 : 


。 如 果 遗 嘱 保 留 被 设置 为 0， 服 务 端 必须 将 遗嘱 消息 当 作 非 保留 消息 发 布 [MQTT-3.1.2- 
16] 。 


。 如 果 遗 嘱 保 留 被 设置 为 1， 服 务 端 必 须 将 遗嘱 消息 当 作 保留 消息 发 布 [MQTT-3.1.2-17]。 


用 户 名 标志 User Name Flag 
位 置 : 连接 标志 的 第 7 位 。 


如 果 用 户 名 (User Name) 标志 被 设置 为 0， 有效 载 荷 中 不 能 包含 用 户 名 字段 [MQTT-3.1.2- 
18] 。 


如 果 用 户 名 (User Name) 标志 被 设置 为 1， 有 效 载荷 中 必须 包含 用 户 名 字段 [MQTT-3.1.2- 
19]。 

密码 标志 Password Flag 

位 置 : 连接 标志 的 第 6 位 。 


如 果 密 码 (Password) 标志 被 设置 为 0， 有 效 载荷 中 不 能 包含 密码 字段 [MQTT-3.1.2-20] 。 


如 果 密 码 (Password) 标志 被 设置 为 1， 有 效 载荷 中 必须 包含 密码 字段 [MQTT-3.1.2-21] 。 


如 果 用 户 名 标志 被 设置 为 0， 密 码 标志 也 必须 设置 为 0 [MQTT-3.1.2-22] 。 


保持 连接 Keep Alive 
图 例 3.5 保 持 连接 字 节 


Bit 7 6 5 4 3 2 1 0 
byte 9 保持 连接 Keep Alive MSB 
byte 10 保持 连接 Keep Alive LSB 
人 
端 传输 完 0 | 报 文 的 时 刻 到 发 送 下 一 个 报 文 的 时 刻 ， 两 者 之 间 允 许 空间 的 最 大 时 间 间 


隔 。 客 户 端 负责 保证 控制 报 文 发 送 的 时 间 间 隔 不 超过 保持 连接 的 值 。 如 果 没 有 任何 其 它 的 控 
制 报 文 可 0 ， 客户 端 必须 发 送 一 个 PINGREQ 报 文 [MQTT-3.1.2-23] 。 


不 管 保持 连接 的 值 是 多 少 ， 客 户 端 任何 时 候 都 可 以 发 送 PINGREQ 报 文 ， 并 且 使 用 PINGRESP 
报 文 判断 网 络 和 服务 端的 活动 状态 。 


如 果 保 持 连接 的 值 非 零 ， 并 且 服 务 端 在 一 点 五 倍 的 保持 连接 时 间 内 没有 收 到 客户 端的 控制 报 
文 ， 它 必须 断 开 客户 端的 网 络 连接 ， 认 为 网 络 连接 已 断 开 [MQTT-3.1.2-24] 。 


客户 端 发 送 了 PINGREQ 报 文 之 后 ， 如 果 在 合理 的 时 间 内 仍 没 有 收 到 PINGRESP 报 文 ， 它 应 该 
关闭 到 服务 端的 网 络 连 接 。 


保持 连接 的 值 为 零 表 示 关 闭 保 持 连 接 功 能 。 这 意味 着 ， 服 务 端 不 需要 因为 客户 端 不 活跃 而 断 
开 连 接 。 注 意 : 不 管 保持 连接 的 值 是 多 少 ， 任 何 时 候 ， 只 要 服务 端 认为 客户 端 是 不 活跃 或 无 
响应 的 ， 可 以 断 开 客户 端的 连接 。 


非 规范 评注 
保持 连接 的 实际 值 是 由 应 用 指定 的 ， 一 般 是 几 分 钟 。 允 许 的 最 大 值 是 18 小 时 12 分 15 秒 。 
可 变 报头 非 规范 示例 


图 例 3.6 -可 变 报 头 非 规范 示 合 


Figure 3.6 - Variable header non normative example 


een |7|s|s|l4lslalle 


Protocol Name 


TC 
Tea rr Tr To To 
me mm ll 


Protocol Level 


m7 


Connect Flags 


User Name Flag (1) 
Password Flag (1) 
Will Retain (0) 

byte 8 Will QoS (01) 
Will Flag (1) 
Clean Session (1) 
Reserved (0) 


Keep Alive 


byte 9 Keep Alive MSB (0) 
byte 10 Keep Alive LSB (10) 





3.1.3 有 效 载荷 Payload 
CONNECT 报 文 的 有 效 载荷 (payload) 包含 一 个 或 多 个 以 长 度 为 前 组 的 字段 ， 可 变 报头 中 的 


标志 决定 是 否 包 含 这 些 字段 。 如 果 包 含 的 话 ， 必 须 按 这 个 顺序 出 现 : 客户 端 标识 符 ， 遗 嘱 主 
题 ， 遗 嘱 消 息 ， 用 户 名 ， 密 码 [MQTT-3.1.3-1] 。 


客户 端 标识 符 Client Identifier 

服务 端 使 用 客户 端 标识 符 (Clientld) 识别 客户 端 。 连接 服务 端的 每 个 客户 端 都 有 唯一 的 客户 端 
标识 符 (Clientld) 。 客 户 端 和 服务 端 都 必须 使 用 Clientld 识 别 两 者 之 间 的 MQTT 会 话 相 关 的 状 
态 [MQTT-3.1.3-2] 。 

客户 端 标识 符 (Clientld) 必须 存在 而 且 必 须 是 CONNECT 报 文 有 效 载荷 的 第 一 个 字段 [MQTT- 
3.1.3-3] ° 

客户 端 标 识 符 必须 是 1.5.3 节 定义 的 UTF-8 编 码 字符 串 [MQTT-3.1.3-4] 。 


服务 端 必须 允许 1 到 23 个 字 节 长 的 UTF-8 编 码 的 客户 端 标识 符 ， 客 户 端 标识 符 只 能 包含 这 些 字 
符 : “0123456789abcdefghijkiImnopqrstuvwwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ”( 大 
写字 母 ， 小 写字 母 和 数字 ) [MQTT-3.1.3-5] 。 


服务 端 可 以 允许 编码 后 超过 23 个 字 节 的 客户 端 标识 符 (Clientld)。 服 务 端 可 以 允许 包含 不 是 上 
面 列 表 字 符 的 客户 端 标识 符 (Clientld)。 


服务 端 可 以 允许 客户 端 提 供 一 个 零 字 节 的 客户 端 标 识 符 (Clientld) ， 如 果 这 样 做 了 ， 服 务 端 必 
须 将 这 看 作 特 殊 情 况 并 分 配 唯 一 的 客户 端 标识 符 给 那个 客户 端 。 然 后 它 必 须 假 设 客户 端 提 供 
了 那个 唯一 的 客户 端 标识 符 ， 正 常 处 理 这 个 CONNECT 报 文 [MQTT-3.1.3-6] 。 


如 果 客 户 端 提供 了 一 个 零 字 节 的 客户 端 标识 符 ， 它 必须 同时 将 清理 会 话 标志 设置 为 1 [MQTT- 
3.1.3-7] 。 


如 果 客 户 端 提 供 的 Clientld 为 零 字 节 且 清理 会 话 标志 为 0， 服 务 端 必须 发 送 返回 码 为 0Ox02 ( 表 
示 标 识 符 不 合格 ) 的 CONNACK 报 文 响应 客户 端的 CONNECT 报 文 ， 然 后 关闭 网 络 连接 
[MQTT-3.1.3-8] 。 


如 果 服 务 端 拒 绝 了 这 个 Clientld， 它 必须 发 送 返回 码 为 0x02 (表示 标识 符 不 合格 ) 的 
CONNACK 报 文 响应 客户 端的 CONNECT 报 文 ， 然 后 关闭 网 络 连接 [MQTT-3.1.3-9] 。 


非 规范 评注 
客户 端 实现 可 以 提供 一 个 方便 的 方法 用 于 生成 随机 的 Clientld。 当 清理 会 话 标志 被 设置 为 
0 时 应 该 主动 放弃 使 用 这 种 方法 。 
遗嘱 主题 Will Topic 
如 果 遗 嘱 标 志 被 设置 为 1， 有 效 载荷 的 下 一 个 字段 是 遗嘱 主题 (Will Topic) 。 遗 嘱 主题 必须 是 
1.5.3 节 定义 的 UTF-8 编 码 字 符 串 [MQTT-3.1.3-10]。 
遗嘱 消息 Will Message 


如 果 遗 嘱 标 志 被 设置 为 1， 有 效 载荷 的 下 一 个 字段 是 遗嘱 消息 。 遗 嘱 消息 定义 了 将 被 发 布 到 遗 
嘱 主 题 的 应 用 消息 ， 见 3.1.2.5 节 的 描述 。 这 个 字段 由 一 个 两 字 节 的 长 度 和 遗嘱 消息 的 有 效 载 
荷 组 成 ， 表 示 为 零 字 节 或 多 个 字 节 序列 。 长 度 给 出 了 跟 在 后 面 的 数据 的 字 节 数 ， 不 包含 长 度 
字段 本 身 占 用 的 两 个 字 节 。 


遗嘱 消息 被 发 布 到 遗嘱 主题 时 ， 它 的 有 效 载荷 只 包含 这 个 字段 的 数据 部 分 ， 不 包含 开头 的 两 
个 长 度 字 节 。 


用 户 名 User Name 


如 果 用 户 名 (User Name) 标志 被 设置 为 1， 有 效 载荷 的 下 一 个 字段 就 是 它 。 用 户 名 必须 是 
1.5.3 节 定义 的 UTF-8 编 码 字 符 串 [MQTT-3.1.3-11]。 服 务 端 可 以 将 它 用 于 身份 验证 和 授权 。 


密码 Password 


如 果 密 码 (Password) 标志 被 设置 为 1， 人 。 密 码 字 段 包 含 一 个 
两 字 节 的 长 度 字 段 ， 长 度 表示 二 进 制 数据 的 字 节 数 (不 包含 长 度 字 段 本 身 占用 的 两 个 字 
节 ) ， 后 面 跟 着 0 到 65535 字 节 的 二 进 制 数 据 。 


Bit 7-0 
byte 1 数据 长 度 MSB 
byte 2 数据 长 度 LSB 
byte 3 .... 如 果 长 度 大 于 0， 这 里 就 是 数据 部 分 


3.1.4 响应 Response 


注意 : 服务 器 可 以 在 同一 个 TCP 端 口 或 其 他 网 络 端 点 上 支持 多 种 协议 ( 包括 本 协议 的 早期 版 
本 ) 。 如 果 服 务 器 确定 协议 是 MQTT 3.1.1， 那 么 它 按照 下 面 的 方法 验证 连接 请 求 。 


1. 网 络 连接 建立 后 ， 如 果 服 务 端 在 合理 的 时 间 内 没有 收 到 CONNECT 报 文 ， 服 务 端 应 该 关 
闭 这 个 连接 。 
2. 服务 端 必须 按照 3.1 节 的 要 求 验 证 CONNECT 报 文 ， 如 果 报 文 不 符合 规范 ， 服 务 端 不 发 送 
CONNACK 报 文 直接 关闭 网 络 连 接 [MQTT-3.1.4-1] 。 
3. 服务 端 可 以 检查 CONNECT 报 文 的 内 容 是 不 是 满足 任何 进一步 的 限制 ， 可 以 执行 身份 验 
人 。 如 果 任何 一 项 检查 没 通 过 ， 按 照 3.2 节 的 描述 ， 它 应 该 发 送 一 个 适当 的 、 
返回 码 非 零 的 CONNACK 响 应 ， 并 且 必 须 关闭 这 个 网 络 连 接 。 


如 果 验 证 成 功 ， 服 务 端 会 执行 下 列 步骤 。 


1， 如 果 Clientld 表 明 客 户 端 已 经 连接 到 这 个 服务 端 那么 服务 端 必须 断 开 原 有 的 客户 端 连接 
[MQTT-3.1.4-2] 。 

2， 服 务 端 必须 按照 3.1.2.4 节 的 描述 执行 清理 会 话 的 过 程 [MQTT-3.1.4-3] 。 

3， 服 务 端 必须 发 送 返回 码 为 零 的 CONNACK 报 文 作为 CONNECT 报 文 的 确认 响应 [MQTT- 
3.1.4-4] 。 

4. 开始 消息 分 发 和 保持 连接 状态 监视 。 


允许 客户 端 在 发 送 CONNECT 报 文 之 后 立即 发 送 其 它 的 控制 报 文 ; 客户 端 不 需要 等 待 服务 端 
的 CONNACK 报 文 。 如 果 服 务 端 拒 绝 了 CONNECT， 它 不 能 处 理 客户 端 在 CONNECT 报 文 之 后 
发 送 的 任何 数据 [MQTT-3.1.4-5] 。 


非 规 范 评注 
客户 端 通常 会 等 待 一 个 CONNACK 报 文 。 然 而 客户 端 有 权 在 收 到 CONNACK 之 前 发 送 控 


制 报 文 ， 由 于 不 需要 维持 连接 状态 ， 这 可 以 简化 客户 端的 实现 。 
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3.2 CONNACK - 确认 连接 请 求 


服务 端 发 送 CONNACK 报 文 响应 从 客户 端 收 到 的 CONNECT 报 文 。 服 务 端 发 送 给 客户 端的 第 
一 个 报 文 必须 是 CONNACK [MQTT-3.2.0-1]。 


如 果 客 户 端 在 合理 的 时 间 内 没有 收 到 服务 端的 CONNACK 报 文 ， 客 户 端 应 该 关闭 网 络 连接 
合理 的 时 间 取 决 于 应 用 的 类 型 和 通信 基础 设施 。 


3.2.1 固定 报头 


固定 报头 的 格式 见 图 例 3.8 - CONNACK 报 文 国定 报头 的 描述 。 


图 例 3.8 - CONNACK 报 文 固定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 报 文 类 型 (2) Reserved 保留 位 
0 0 1 0 0 0 0 0 
byte 2 剩余 长 度 (2) 
0 0 0 0 0 0 1 0 


表示 可 变 报 头 的 长 度 。 对 于 CONNACK 报 文 这 个 值 等 于 2。 


3.2.2 可 变 报头 
可 变 报 头 的 格式 见 图 例 3.9 -CONNACK 报 文 可 变 报头 的 描述 。 


图 例 3.9 -CONNACK 报 文 可 变 报 头 
首 述 7 6 5 4 3 2 1 0 
连接 确认 标志 Reserved 保留 位 SP 
byte 1 0 0 0 0 0 0 0 X 


连接 返回 码 
byte 2 X X X X X X X X 


首 述 7 6 5 4 3 2 1 0 


连接 确认 标志 Reserved 保留 位 SP1 
byte 1 0 0 0 0 0 0 0 X 
连接 返回 码 
byte 2 X X X X X X X X 


连接 确认 标志 Connect Acknowledge Flags 


第 1 个 字 节 是 连接 确认 标志 ， 位 7-1 是 保留 位 且 必 须 设置 为 0。 第 0 (SP) 位 是 当前 会 话 
(Session Present) 标志 。 


当前 会 话 Session Present 
位 置 : 连接 确认 标志 的 第 0 位 。 


如 果 服 务 端 收 到 清理 会 话 (CleanSession) 标志 为 1 的 连接 ， 除 了 将 CONNACK 报 文中 的 返回 
码 设 置 为 0 之 外 ， 还 必须 将 CONNACK 报 文中 的 当前 会 话 设置 (Session Present) 标志 为 0 
[MQTT-3.2.2-1] 。 


如 果 服 务 端 收 到 一 个 CleanSession 为 0 的 连接 ， 当 前 会 话 标志 的 值 取决 于 服务 端 是 否 已 经 保存 
了 Clientld 对 应 客户 端的 会 话 状 态 。 如 果 服 务 端 已 经 保存 了 会 话 状态 ， 它 必须 将 CONNACK 报 

文中 的 当前 会 话 标志 设置 为 1 [MQTT-3.2.2-2] 。 如 果 服务 端 没有 已 保存 的 会 话 状态 ， 它 必须 将 
CONNACK 报 文中 的 当前 会 话 设置 为 0。 还 需要 将 CONNACK 报 文中 的 返回 码 设 置 为 0 [MQTT- 
:a 


当前 会 话 标志 使 服务 端 和 客户 端 在 是 否 有 已 存储 的 会 话 状态 上 保持 一 致 。 


一 旦 完成 了 会 话 的 初始 化 设置 ， 已 经 保存 会 话 状态 的 客户 端 将 期 望 服 务 端 维 持 它 存储 的 会 话 
状态 。 如 果 客 户 端 从 服务 端 收 到 的 当前 的 值 与 预期 的 不 同 ， 客 户 端 可 以 选择 继续 这 个 会 话 或 
者 断 开 连接 。 客 户 端 可 以 丢弃 客户 端 和 服务 端 之 间 的 会 话 状态 ， 方 法 是 ， 断 开 连 接 ， 将 清理 
会 话 标志 设置 为 1， 再 次 连接 ， 然 后 再 次 断 开 连接 。 

如 果 服 务 端 发 送 了 一 个 包含 非 零 返回 码 的 CONNACK 报 文 ， 它 必须 将 当前 会 话 标志 设置 为 0 


[MQTT-3.2.2-4] 。 


连接 返回 码 Connect Return code 
位 置 : 可 变 报 头 的 第 2 个 字 节 。 


连接 返回 码 字 段 使 用 一 个 字 节 的 无 符号 值 ， 在 表格 3.1 一 连接 返回 码 的 值 中 列 出 。 如 果 服 务 
端 收 到 一 个 合法 的 CONNECT 报 文 ， 但 出 于 某 些 原因 无 法 处 理 它 ， 服 务 端 应 该 党 试 发 送 一 个 
包含 非 零 返回 码 (表格 中 的 某 一 个 ) 的 CONNACK 报 文 。 如 果 服 务 端 发 送 了 一 个 包含 非 零 返 


回 码 的 CONNACK 报 文 ， 那 么 它 必 须 关 闭 网 络 连 接 [MQTT-3.2.2-5].。 


表格 3.1 -连接 返回 码 的 值 


值 返回 码 响 应 描述 

0 0x00 连 接 已 接受 连接 已 被 服务 端 接受 

1 0 人 服务 端 不 支持 客户 端 请 求 的 MQTT 协 议 级 别 

2 0x02 连 接 已 拒绝 ， 不 合格 的 客户 ” 客户 端 标 识 符 是 正确 的 UTF-8 编 码 ， 但 服务 
端 标 识 符 端 不 允许 使 用 


3 0x03 连 接 已 拒绝 ， 服 务 端 不 可 用 网 络 连接 已 建立 ， 但 MQTT 服 务 不 可 用 


0x04 连 接 已 拒绝 ， 无 效 的 用 户 名 


4 用 户 名 或 密码 的 数据 格式 无 效 


5 0x05 连 接 已 拒绝 ， 未 授权 客户 端 未 被 授权 连接 到 此 服务 器 
6- 女 
255 保留 


如 果 认 为 上 表 中 的 所 有 连接 返回 码 都 不 太 合 适 ， 那 么 服务 端 必 须 关 闭 网 络 连 接 ， 不 需要 发 送 
CONNACK 报 文 [MQTT-3.2.2-6] 。 


3.2.3 有 效 载荷 


CONNACK 报 文 没有 有 效 载荷 。 
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3.3 PUBLISH - 发 布 消息 

PUBLISH 控 制 报 文 是 指 从 客户 端 向 服务 端 或 者 服务 客户 端 传 输 一 个 应 用 消息 。 
3.3.1 固定 报头 

图 例 3.10 -~- PUBLISH 报 文 国 定 报头 描述 了 国定 报头 的 格式 


图 例 3.10 -PUBLISH 报 文 固定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (3) DUP QoS-H QoS- RETAIN 
0 0 1 1 X X X X 
byte 2... 剩余 长 度 


重 发 标志 DUP 
位 置 : 第 1 个 字 节 ， 第 3 位 


如 果 DUP 标 志 被 设置 为 0， 表 示 这 是 客户 端 或 服务 端 第 一 次 请 求 发 送 这 个 PUBLISH 报 文 。 如 
果 DUP 标 志 被 设置 为 1， 表 示 这 可 能 是 一 个 早 前 报 文 请 求 的 重 发 。 


客户 端 或 服务 端 请 求 重 发 一 个 PUBLISH 报 文 时 ， 必 须 将 DUP 标 志 设 置 为 1 [MQTT-3.3.1.-1].。 
对 于 QoS 0 的 消息 ，DUP 标 志 必 须 设置 为 0 [MQTT-3.3.1-2]。 


服务 端 发 送 PUBLISH 报 文 给 订阅 者 时 ， 收 到 (入 站 ) 的 PUBLISH 报 文 的 DUP 标 志 的 值 不 会 被 
传播 。 发 送 (出 站 ) 的 PUBLISH 报 文 与 收 到 (入 站 ) 的 PUBLISH 报 文中 的 DUP 标 志 是 独立 设 
置 的 ， 它 的 值 必 须 单 独 的 根据 发 送 (出 站 ) 的 PUBLISH 报 文 是 否 是 一 个 重 发 来 确定 [MQTT- 

3.3.1-3] 。 


非 规 范 评注 
接收 者 收 到 一 个 DUP 标 志 为 1 的 控制 报 文 时 ， 不 能 假设 它 看 到 了 一 个 这 个 报 文 之 前 的 一 个 
非 规范 评注 
需要 特别 指出 的 是 ，DUP 标 志 关注 的 是 控制 报 文本 身 ， 信 的 应 用 消息 无 关 。 当 使 
用 QoS 1 时 ， 客 户 端 马 ee ws ， 这 个 报 文 包含 一 个 它 


之 前 收 到 过 的 应 用 消息 的 副本 ， 但 是 用 的 是 不 同 的 报 文 标识 符 。 2.3.1 节 提供 了 有 关 报 文 
标识 符 的 更 多 信息 。 


表格 3.2 -服务 质量 定义 


QoS 值 Bit 2 Bit 1 描述 
0 0 0 最 多 分 发 一 次 
0 1 宇 》 分 公 二 光 
1 0 只 分 发 一 次 
= 1 1 保留 位 


PUBLISH 报 文 不 能 将 QoS 所 有 的 位 设置 为 1。 如 果 服 务 端 或 客户 端 收 到 QoS 所 有 位 都 为 1 的 
PUBLISH 报 文 ， 它 必须 关闭 网 络 连接 [MQTT-3.3.1-4] 。 


保留 标志 RETAIN 


如 果 客 户 端 发 给 服务 端的 PUBLISH 报 文 的 保留 (RETAIN) 标志 被 设置 为 1， 服 务 端 必 须 存 储 
这 个 应 用 消息 和 它 的 服务 质量 等 级 (QoS) ， 以 便 它 可 以 被 分 发 给 未 来 的 主题 名 匹配 的 订阅 
者 [MQTT-3.3.1-5]。 一 个 新 的 订阅 建立 时 ， 对 每 个 匹配 的 主题 名 ， 如 果 存 在 最 近 保留 的 消 
息 ， 它 必须 被 发 送 给 这 个 订阅 者 [MQTT-3.3.1-6]。 如 果 服 务 端 收 到 一 条 保留 (RETAIN) 标志 
为 1 的 QoS 0 消息 ， 它 必须 丢弃 之 前 为 那个 主题 保留 的 任何 消息 。 它 应 该 将 这 个 新 的 QoS 0 消 
息 当 作 那 个 主题 的 新 保留 消息 ， 但 是 任何 时 候 都 可 以 选择 丢弃 它 一 如 果 这 种 情况 发 生 了 ， 那 
个 主题 将 没有 保留 消息 [MQTT-3.3.1-7]。 有 关 存 储 状 态 的 更 多 信息 见 4.1 节 。 


服务 端 发 送 PUBLISH 报 文 给 客户 端 时 ， 如 果 消 息 是 作为 客户 端 一 个 新 订阅 的 结果 发 送 ， 它 必 
须 将 报 文 的 保留 标志 设 为 1 [MQTT-3.3.1-8] 。 当 一 个 PUBLISH 报 文 发 送 给 客户 端 是 因为 匹配 一 
个 已 建立 的 订阅 时 ， 服 务 端 必须 将 保留 标志 设 为 0， 不 管 它 收 到 的 这 个 消息 中 保留 标志 的 值 是 
多 少 [MQTT-3.3.1-9] 。 


保留 标志 为 1 且 有 效 载荷 为 零 字 节 的 PUBLISH 报 文 会 被 服务 端 当 作 正常 消息 处 理 ， 它 会 被 发 送 
给 订阅 主题 匹配 的 客户 端 。 此外， 同一 个 主题 下 任何 现存 的 保留 消息 必须 被 移 除 ， 因 此 这 个 
主题 之 后 的 任何 订阅 者 都 不 会 收 到 一 个 保留 消息 [MQTT-3.3.1-10]。 当 作 正 常 意思 是 现存 的 客 
户 端 收 到 的 消息 中 保留 标志 未 被 设置 。 服 务 端 不 能 存储 零 字 节 的 保留 消息 [MQTT-3.3.1-11] 。 


如 果 客 户 端 发 给 服务 端的 PUBLISH 报 文 的 保留 标志 位 0， 服 务 端 不 能 存储 这 个 消息 也 不 能 移 除 
或 替换 任何 现存 的 保留 消息 [MQTT-3.3.1-12]。 


非 规范 评注 


对 于 发 布 者 不 定期 发 送 状态 消息 这 个 场景 ， 保 留 消息 很 有 用 。 新 的 订阅 者 将 会 收 到 最 近 


只 
的 状态 。 
剩余 长 度 字段 


等 于 可 变 报头 的 长 度 加 上 有 效 载荷 的 长 度 。 


3.3.2 可 变 报 头 


可 变 报 头 按 顺序 包含 主题 名 和 报 文 标识 符 。 


主题 名 Topic Name 
主题 名 (Topic Name) 用 于 识别 有 效 载荷 数据 应 该 被 发 布 到 哪 一 个 信息 通道 。 


主题 名 必须 是 PUBLISH 报 文 可 变 报头 的 第 一 个 字段 。 它 必须 是 1.5.3 节 定义 的 UTF-8 编 码 的 字 
符 串 [MQTT-3.3.2-1] 。 


PUBLISH 报 文中 的 主题 名 不 能 包含 通配符 [MQTT-3.3.2-2]。 


服务 端 发 送 给 订阅 客户 端的 PUBLISH 报 文 的 主题 名 必须 匹配 该 订阅 的 主题 过 滤器 (根据 4.7 
节 定义 的 匹配 过 程 ) [MQTT-3.3.2-3] 。 


报 文 标识 符 Packet ldentifier 


只 有 当 QoS 等 级 是 1 或 2 时 ， 报 文 标识 符 (Packet ldentifier) 字段 才能 出 现在 PUBLISH 报 文 
中 。2.3.1 节 提供 了 有 关 报 文 标识 符 的 更 多 信息 。 


可 变 报 头 非 规范 示例 


图 例 3.11 一 PUBLISH 报 文 可 变 报头 非 规范 示例 举例 说 明了 表格 3.3 - PUBLISH 报 文 非 规范 示 
例 中 简要 描述 的 PUBLISH 报 文 的 可 变 报头 。 


</span></span> 表 格 3.3 - PUBLISH 报 文 非 规范 示例 


Field Value 
主题 名 a/b 
报 文 标识 符 10 


图 例 3.11 一 PUBLISH 报 文 可 变 报 头 非 规范 示例 


襄 
由 
~ 
© 
a 
2 
Co 
ID 
人 
© 


Topic Name 主题 名 


byte 1 Length MSB (0) 01|10|1010101010 10 
byte 2 Length LSB (3) 0 0 0 0 0 0 1 1 
byte 3 ‘a’ (Ox61) 0 1 le Om OO Oa el 
byte 4 ‘7 (Ox2F) 0 0 1 0 1 1 1 1 
byte 5 ‘b’ (Ox62) 0 1 ll ee Om ea Ol Oa el 0 
报 文 标识 符 

byte 6 报 文 标识 符 MSB (0) OOo ono oo o 
byte 7 报 文 标识 符 LSB (10) 0 0 0 0 1 0 1 0 


示例 中 的 主题 名 为 “a/b”， 长 度 等 于 3， 报 文 标识 符 为 “10” 


3.3.3 有 效 载荷 


有 效 载荷 包含 将 被 发 布 的 应 用 消息 。 数 据 的 内 容 和 格式 是 应 用 特定 的 。 有 效 载荷 的 长 度 这 样 
计算 : 用 国定 报头 中 的 剩余 长 度 字段 的 值 减 去 可 变 报头 的 长 度 。 包 含 零 长 度 有 效 载 荷 的 
PUBLISH 报 文 是 合法 的 。 


3.3.4 响应 


PUBLISH 报 文 的 接收 者 必须 按照 根据 PUBLISH 报 文中 的 QoS 等 级 发 送 响应 ， 见 下 面 表 格 的 描 
述 [MQTT-3.3.4-1] 。 


表格 3.4- PUBLISH 报 文 的 预期 响应 


服务 质量 等 级 预期 响应 
QoS 0 无 响应 
QoS 1 PUBACK 报 文 
QoS 2 PUBREC 报 文 


3.3.5 动作 Actions 
客户 端 使 用 PUBLISH 报 文 发 送 应 用 消息 给 服 ， 目 的 是 分 发 到 其 它 订 阅 匹 配 的 客户 端 。 


服务 端 使 用 PUBLISH 报 文 发 送 应 用 消息 给 每 一 个 订阅 匹配 的 客户 端 。 


客户 端 使 用 带 通配符 的 主题 过 滤器 请 求 订阅 时 ， 客 户 端的 订阅 可 能 会 重复 ， 因 此 发 布 的 消息 
可 能 会 匹配 多 个 过 滤器 。 对 于 这 种 情况 ， 服 务 端 必 须 将 消息 分 发 给 所 有 订阅 匹配 的 QoS 等 级 
最 高 的 客户 端 [MQTT-3.3.5-1]。 服 务 端 之 后 可 以 按照 订阅 的 QoS 等 级 ， 分 发 消息 的 副本 给 每 
一 个 匹配 的 订阅 者 。 


收 到 一 个 PUBLISH 报 文 时 ， 接 收 者 的 动作 取决 于 4.3 节 描述 的 QoS 等 级 。 


如 果 服 务 端 实现 不 授权 某 个 客户 端 发 布 PUBLISH 报 文 ， 它 没有 办 法 通知 那个 客户 端 。 它 必须 
按照 正常 的 QoS 规则 发 送 一 个 正面 的 确认 ， 或 者 关闭 网 络 连接 [MQTT-3.3.5-2] 。 


第 三 章 目录 MQTT 控 制 报 文 


3.0 Contents 一 MQTT 控 制 报 文 

3.1 CONNECT - 连接 服务 端 

e。 3.2 CONNACK - 确认 连接 请 求 

。 3.3 PUBLISH 一 发 布 消息 

。 3.4 PUBACK -发 布 确认 

。 3.5 PUBREC 一 发布 收 到 (QoS 2， 第 一 步 
。 3.6 PUBREL 一 发 布 释放 (QoS 2， 第 二 步 
。 3.7 PUBCOMP 一 发布 完 成 (QoS 2， 第 三 
。 3.8 SUBSCRIBE - 订阅 主题 

3.9 SUBACK - 订阅 确认 

。 3.10 UNSUBSCRIBE -取消 订阅 

3.11 UNSUBACK -取消 订阅 确认 

3.12 PINGREQ - 心跳 请 求 

。 3.13 PINGRESP -心跳 响应 

。 3.14 DISCONNECT -- 断 开 连 接 


) 


) 
步 ) 


项 目 主页 
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3.4 PUBACK -发 布 确认 
PUBACK 报 文 是 对 QoS 1 等 级 的 PUBLISH 报 文 的 响应 。 


3.4.1 固定 报头 


图 例 3.12 - PUBACK 报 文 国定 报头 


Bit 7 6 5 4 3 
byte 1 MQTT 报 文 类 型 (4) 
0 1 0 0 0 
byte 2... 剩余 长 度 
0 0 0 0 0 


表示 可 变 报头 的 长 度 。 对 PUBACK 报 文 这 个 值 等 于 2. 


包含 等 待 确认 的 PUBLISH 报 文 的 报 文 标识 符 。 


图 例 3.13 - PUBACK 报 文 可 变 报头 


Bit 7 6 5 4 3 
byte 1 报 文 标 识 符 MSB 
byte 2 报 文 标识 符 LSB 


3.4.3 有 效 载荷 


PUBACK 报 文 没有 有 效 载 荷 。 


第 三 章 目 录 MQTT 控 制 报 文 


e 3.0 Contents - MQTT 控 制 报 文 


3.4 PUBACK -发 布 确认 


3.1 CONNECT - 连接 服务 端 

3.2 CONNACK -- 确认 连接 请 求 

3.3 PUBLISH 一 发 布 消息 

3.4 PUBACK -发 布 确认 

3.5 PUBREC - 发 布 收 到 (QoS 2， 第 一 步 ) 
3.6 PUBREL 一 发 布 释放 (QoS 2， 第 二 步 ) 
3.7 PUBCOMP 一 发布 完成 (QoS 2， 第 三 步 ) 
3.8 SUBSCRIBE - 订阅 主题 

3.9 SUBACK - 订阅 确认 

3.10 UNSUBSCRIBE -取消 订阅 

3.11 UNSUBACK - 取消 订阅 确认 

3.12 PINGREQ 一 心跳 请 求 

3.13 PINGRESP -- 心跳 响应 

3.14 DISCONNECT -- 断 开 连 接 
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3.5 PUBREC - 发 布 收 到 (QoS 2， 第 一 步 ) 


PUBREC 报 文 是 对 QoS 等 级 2 的 PUBLISH 报 文 的 响应 。 它 是 QoS 2 等 级 协议 交换 的 第 二 个 报 
文 o 


3.5.1 固定 报头 


图 例 3.14 - PUBREC 报 文 国定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (5) 保留 位 
0 1 0 1 0 0 0 0 
byte 2 剩余 长 度 (2) 
0 0 0 0 0 0 1 0 
剩余 长 度 字段 


报头 


OO 
own 
IN 
过 
oa 


可 变 报头 包含 等 待 确认 的 PUBLISH 报 文 的 报 文 标识 符 。 


图 例 3.15 - PUBREC 报 文 可 变 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 报 文 标识 符 MSB 
byte 2 报 文 标识 符 LSB 


3.5.3 有 效 载 荷 


PUBREC 报 文 没有 有 效 载荷 。 


第 三 章 目录 MQTT 控 制 报 文 


3.5 PUBREC - 发 布 收 到 (QoS 2， 第 一 步 ) 


3.0 Contents 一 MQTT 控 制 报 文 

3.1 CONNECT 一 连接 服务 端 

3.2 CONNACK - 确认 连接 请 求 

3.3 PUBLISH - 发 布 消息 

3.4 PUBACK -发 布 确认 

3.5 PUBREC - 发 布 收 到 (QoS 2， 第 一 步 ) 
3.6 PUBREL 一 发 布 释放 (QoS 2 ， AS 
3.7 PUBCOMP 一 发布 完成 (QoS 2， 第 三 步 ) 
3.8 SUBSCRIBE - 订阅 主题 

3.9 SUBACK - 订阅 确认 

3.10 UNSUBSCRIBE -取消 订阅 

3.11 UNSUBACK - 取消 订阅 确认 

3.12 PINGREQ -- 心跳 请 求 

3.13 PINGRESP 一 心跳 响应 

3.14 DISCONNECT -- 断 开 连 接 
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3.6 PUBREL - 发 布 释放 (QoS 2， 第 二 步 ) 


PUBREL 报 文 是 对 PUBREC 报 文 的 响应 。 它 是 QoS 2 等 级 协议 交换 的 第 三 个 报 文 。 


3.6.1 固定 报头 


图 例 3.16 - PUBREL 报 文 固定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (6) 保留 位 

1 1 0 0 0 0 1 0 
byte 2 剩余 长 度 (2) 

0 0 0 0 0 0 1 0 


PUBREL 控 制 报 文 固定 报头 的 第 3,2,1,0 位 是 保留 位 ， 必 须 被 设置 为 0,0,1,0。 服 务 端 必须 将 其 
它 的 任何 值 都 当做 是 不 合法 的 并 关闭 网 络 连 接 [MQTT-3.6.1-1] 。 


剩余 长 度 字段 

表示 可 变 报 头 的 长 度 。 对 PUBREL 报 文 这 个 值 等 于 2. 

3.6.2 可 变 报 头 

可 变 报 头 包 含 与 等 待 确认 的 PUBREC 报 文 相同 的 报 文 标识 符 。 


图 例 3.17 - PUBREL 报 文 可 变 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 报 文 标识 符 MSB 
byte 2 报 文 标识 符 LSB 


3.6.3 有 效 载 荷 


PUBREL 报 文 没有 有 效 载 荷 。 


3.6 PUBREL - 发 布 释 放 (QoS 2， 第 二 步 ) 


第 三 章 目 录 MQTT 控 制 报 文 


3.0 Contents 一 MQTT 控 制 报 文 

3.1 CONNECT 一 连接 服务 端 

3.2 CONNACK - 确认 连接 请 求 

3.3 PUBLISH 一 发布 消息 

3.4 PUBACK -发 布 确认 

3.5 PUBREC - 发 布 收 到 (QoS 2， 第 一 步 ) 
3.6 PUBREL - 发 布 释放 (QoS 2， 
3.7 PUBCOMP 一 发 布 完成 (QoS 2， 第 三 
3.8 SUBSCRIBE - 订阅 主题 

3.9 SUBACK - 订阅 确认 

3.10 UNSUBSCRIBE -取消 订阅 

3.11 UNSUBACK -取消 订阅 确认 
3.12 PINGREQ 一 心跳 请 求 

3.13 PINGRESP -- 心跳 响应 

3.14 DISCONNECT -- 断 开 连 接 


) 
三 步 ) 
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3.7 PUBCOMP - 发 布 完成 (QoS 2， 第 三 步 ) 


PUBCOMP 报 文 是 对 PUBREL 报 文 的 响应 。 它 是 QoS 2 等 级 协议 交换 的 第 四 个 也 是 最 后 一 个 报 
文 o 


3.7.1 固定 报头 


图 例 3.18 - PUBCOMP 报 文 固 定 报 头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (7) 保留 位 

0 1 1 1 0 0 0 0 
byte 2 剩余 长 度 (2) 

0 0 0 0 0 0 1 0 


图 例 3.19 - PUBCOMP 报 文 可 变 报 头 


Bit 7 6 5 4 3 2 1 0 
byte 1 报 文 标识 符 MSB 
byte 2 报 文 标识 符 LSB 


3.7.3 有 效 载 荷 


PUBCOMP 报 文 没有 有 效 载荷 。 


第 三 章 目录 MQTT 控 制 报 文 


3.7 PUBCOMP - 发 布 完成 (QoS 2， 第 三 步 ) 


3.0 Contents 一 MQTT 控 制 报 文 

3.1 CONNECT 一 连接 服务 端 

3.2 CONNACK - 确认 连接 请 求 

3.3 PUBLISH - 发 布 消息 

3.4 PUBACK -发 布 确认 

3.5 PUBREC - 发 布 收 到 (QoS 2， 第 一 步 ) 
3.6 PUBREL 一 发 布 释放 (QoS 2 ， AS 
3.7 PUBCOMP 一 发布 完成 (QoS 2， 第 三 步 ) 
3.8 SUBSCRIBE - 订阅 主题 

3.9 SUBACK - 订阅 确认 

3.10 UNSUBSCRIBE -取消 订阅 

3.11 UNSUBACK - 取消 订阅 确认 

3.12 PINGREQ -- 心跳 请 求 

3.13 PINGRESP 一 心跳 响应 

3.14 DISCONNECT -- 断 开 连 接 
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3.8 SUBSCRIBE - 人 订阅 主题 


客户 端 向 服务 端 发 送 SUBSCRIBE 报 文 用 于 创建 一 个 或 多 个 订阅 。 每 个 订阅 注册 客户 端 关心 的 
一 个 或 多 个 主题 。 为 了 将 应 用 消息 转发 给 与 那些 订阅 匹配 的 主题 ， 服 务 端 发 送 PUBLISH 报 文 
给 客户 端 。SUBSCRIBE 报 文 也 (为 每 个 订阅 ) 指定 了 最 大 的 QoS 等 级 ， 服 务 端 根 据 这 个 发 送 


应 用 消息 给 客户 端 。 
3.8.1 固定 报头 


图 例 3.20 - SUBSCRIBE 报 文 固定 报头 


Bit 7 6 5 


byte 1 MQTT 控 制 报 文 类 型 (8) 保留 位 
1 0 0 10|10|10 11 10 


byte 2 剩余 长 度 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (8) 保留 位 
1 0 0 0 0 0 0 0 
byte 2 剩余 长 度 


SUBSCRIBE 控 制 报国 定 报头 的 第 3,2,1,0 位 是 保留 位 ， 必 须 分 别 设置 为 0,0,1,0。 服 务 端 必 须 将 
其 它 的 任何 值 都 当做 是 不 合法 的 并 关闭 网 络 连接 [MQTT-3.8.1-1] 。 
剩余 长 度 字 段 


等 于 可 变 报头 的 长 度 (2 字 节 ) 加 上 有 效 载荷 的 长 度 。 


3.8.2 可 变 报头 


可 变 报头 包含 报 文 标识 符 。2.3.1 提 供 了 有 关 报 文 标识 符 的 更 多 信 


可 变 报 头 非 规范 示例 
图 例 3.21 一 报 文 标识 符 等 于 10 的 可 变 报 头 ， 非 规范 示例 展示 了 报 文 标识 符 设置 为 10 时 的 可 变 
报头 。 


3 上 庆 一 


图 例 3.21 一 报 文 标识 符 等 于 10 的 可 变 报头 ， 非 规范 示例 


各 
由 
< 
oO 
a 
到 
ww 
I 
一 
© 


报 文 标识 符 
byte 1 报 文 标识 符 MSB (0) | od Ele | So oj ea de 一 区 
byte 2 报 文 标识 符 LSB (10) 010|l0|lo|l1|l0|+110 


3.8.3 有 效 载荷 


SUBSCRIBE 报 文 的 有 效 载荷 包含 了 一 个 主题 过 滤器 列表 ， 它 们 表示 客户 端 想 要 订阅 的 主题 。 
SUBSCRIBE 报 文 有 效 载荷 中 的 主题 过 滤器 列表 必须 是 1.5.3 节 定义 的 UTF-8 字 符 串 [MQTT- 
务 端 应 该 支持 包含 通配符 (4.7.1 节 定义 的 ) 的 主题 过 滤器 。 如 果 服 务 端 选择 不 支 
持 包含 通配符 的 主题 过 滤器 ， 必 须 拒 绝 任何 包含 通配符 过 滤器 的 订阅 请 求 [MQTT-3.8.3-2]。 
es 器 后 面 跟着 一 个 字 节 ， 这 个 字 节 被 叫做 服务 质量 要 求 (Requested QoS ) 。 它 给 
出 了 服务 端 向 客户 端 发 送 应 用 消息 所 允许 的 最 大 QoS 等 级 。 


SUBSCRIBE 报 文 的 有 效 载荷 必须 包含 至 少 一 对 主题 过 滤器 和 QoS 等 级 字段 组 合 。 没 有 有 效 
载荷 的 SUBSCRIBE 报 文 是 违反 协议 的 [MQTT-3.8.3-3]。 有 关 错 误 处 理 的 信息 请 查看 4.8 节 。 


请 求 的 最 大 服务 质量 等 级 字段 编码 为 一 个 字 节 ， 它 后 面 跟着 UTF-8 编 码 的 主题 名 ， 那 些 主题 过 
a 0 


图 例 3.22 - SUBSCRIBE 报 文 有 效 载荷 格式 


描述 7 6 5 4 3 2 1 0 
主题 过 滤器 
byte 1 长 度 MSB 
byte 2 长 度 LSB 
主题 过 滤器 
bytes 3..N 人 


(Topic Filter ) 


服务 质量 要 求 
(Requested QoS ) 


服务 质 
保留 位 量 等 级 


byte N+1 0 0 0 0 0 0 Xx Xx 


byte 1 长 度 MSB 
byte 2 长 度 LSB 
byte 3..N 主题 过 滤器 (Topic Filter ) 
服务 质量 要 求 (Requested QoS) 
保留 位 服务 质量 等 级 
byte N+1 0 0 0 0 0 0 X X 


当前 版 本 的 协议 没有 用 到 服务 质量 要 求 (Requested QoS) 字 节 的 高 六 位 。 如 果 有 效 载荷 中 
的 任何 位 是 非 零 值 ， 或 者 QoS 不 等 于 0,1 或 2， 服 务 端 必须 认为 SUBSCRIBE 报 文 是 不 合法 的 并 
关闭 网 络 连接 [MQTT-3-8.3-4] 。 

有 效 载 荷 非 规范 示例 


图 例 3.23 -~ 有效 载荷 字 节 格 式 非 规范 示例 展示 了 表格 3.5 二 有 效 载荷 非 规 范 示例 中 简 
略 描 述 的 SUBSCRIBE 报 文 的 有 效 载荷 。 


表格 3.5 - 有 效 载荷 非 规范 示例 


主题 名 “alb” 
服务 质量 要 求 Ox01 
主题 名 “Cc/d” 
服务 质量 要 求 Ox02 


图 例 3.23 一 有 效 载荷 字 节 格式 非 规范 示例 


描述 7 6 5 4 3 2 1 0 


主题 过 滤器 (Topic Filter) 


byte 1 Length MSB(0) 0 0 0 0 0 0 0 0 

byte 2 LengthLSB(3) 0 0 0 0 0 0 1 1 

byte 3 a (Ox61) 0 | 1 1 0|10101011 

byte 4 ‘p (0x2F) 0 0 1 0 1 1 1 1 

byte 5 ‘b’ (Ox62) 0 | 1 1 0O|10|0|1 0 

服务 质量 要 求 (Requested 

QoS ) 

byte 6 人 oo ono | oo 

主题 过 滤器 (Topic Filter) 

byte 7 Length MSB(0) 0 0 0 0 0 0 0 0 

byte 8 LengthLSB(3) 0 0 0 0 0 0 1 1 

byte 9 C (Ox63) 0 | 1 1 0 0 0 1 1 

byte 10 ‘p (0x2F) 0|0|111011111111 

byte 11 ‘d' (0x64) 0|1|1|olol1lolo 

服务 质量 要 求 (Requested 

QoS ) 

byte 12 Se 0 oo oo ol 
3.8.4 响应 


服务 端 收 到 客户 端 发 送 的 一 个 SUBSCRIBE 报 文 时 ， 必 须 使 用 SUBACK 报 文 响应 [MQTT- 
3.8.4-1]。SUBACK 报 文 必须 和 等 待 确认 的 SUBSCRIBE 报 文 有 相同 的 报 文 标识 符 [MQTT- 
3.8.4-2] 。 


允许 服务 端 在 发 送 SUBACK 报 文 之 前 就 开始 发 送 与 订阅 匹配 的 PUBLISH 报 文 。 


如 果 服 务 端 收 到 一 个 SUBSCRIBE 报 文 ， 报 文 的 主题 过 滤器 与 一 个 现存 订阅 的 主题 过 滤器 相 
ee 必须 使 用 新 的 订阅 彻底 替换 现存 的 订阅 。 新 订阅 的 主题 过 滤器 和 之 前 订阅 的 相同 ， 

是 它 的 最 大 QoS 值 可 以 不 同 。 与 这 个 主题 过 滤器 匹配 的 任何 现存 的 保留 消息 必须 被 重 发 ， 
能 中 断 [MQTT-3.8.4-3] 。 


如 果 主 题 过 滤器 不 同 于 任何 现存 订阅 的 过 滤器 ， 服 务 端 会 创建 一 个 新 的 订阅 并 发 送 所 有 匹配 
的 保留 消息 。 


3.8 SUBSCRIBE - 订阅 主题 


如 果 服 务 端 收 到 包含 多 个 主题 过 滤器 的 SUBSCRIBE 报 文 ， 它 必须 如 同 收 到 了 一 系列 的 多 个 
SUBSCRIBE 报 文 一 样 处 理 那 个 ， 除 了 需要 将 它们 的 响应 合并 到 一 个 单独 的 SUBACK 报 文 发 送 
[MQTT-3.8.4-4] 。 


服务 端 发 送 给 客户 端的 SUBACK 报 文 对 每 一 对 主题 过 滤器 和 QoS 等 级 都 必须 包含 一 个 返回 
码 。 这 个 返回 码 必 须 表示 那个 订阅 被 授予 的 最 大 QoS 等 级 ， 或 者 表示 这 个 订阅 失败 [MQTT- 
3.8.4-5]。 服 务 端 可 以 授予 比 订 阅 者 要 求 的 低 一 些 的 QoS 等 级 。 为 响应 订阅 而 发 出 的 消息 的 有 
效 载 荷 的 QoS 必须 是 原始 发 布 消息 的 QoS 和 服务 端 授予 的 QoS 两 者 中 的 最 小 值 。 如 果 原 始 消 
息 的 QoS 是 1 而 被 授予 的 最 大 QoS 是 0， 允 许 服务 端 重复 发 送 一 个 消息 的 副本 给 订阅 者 [MQTT- 
3.8.4-6] ° 


非 规范 示例 对 茶 个 特定 的 主题 过 滤 器， 如果 正 在 订阅 的 客户 端 被 授予 的 最 大 QoS 等 级 是 
1， 那 么 匹配 这 个 过 滤器 的 QoS 等 级 0 的 应 用 消息 会 按 QoS 等 级 0 分 发 给 这 个 客户 端 。 这 意 
味 着 客户 端 最 多 收 到 这 个 消息 的 一 个 副本 。 从 另 一 方面 说 ， 发 布 给 同一 主题 的 QoS 等 级 2 
的 消息 会 被 服务 端 降级 到 QoS 等 级 1 再 分 发 给 客户 端 ， 因 此 客户 端 可 能 会 收 到 重复 的 消息 
副本 。 


如 果 正在 订阅 的 客户 端 被 授予 的 最 大 QoS 等 级 是 0， 那 么 原来 按 QoS 等 级 2 发 布 给 客户 端 
的 应 用 消息 在 繁忙 时 可 能 会 丢失 ， 但 是 服务 端 不 应 该 发 送 重复 的 消息 副本 。 发 布 给 同一 
主题 的 QoS 等 级 1 的 消息 在 传输 给 客户 端 时 可 能 会 丢失 或 重复 。 


非 规 范 评注 


使 用 QoS 等 级 2 订阅 一 个 主题 过 滤器 等 于 是 说 : 我 想 要 按照 它们 发 布 时 的 QoS 等 级 接受 匹 
配 这 个 过 滤器 的 消息 。 这 意味 着 ， 确 定 消息 分 发 时 可 能 的 最 大 QoS 等 级 是 发 布 者 的 责 
任 ， 而 订阅 者 可 以 要 求 服务 端 降低 QoS 到 更 适合 它 的 等 级 。 
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3.8 SUBSCRIBE - 订阅 主题 


。 3.14 DISCONNECT - 断 开 连接 
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3.9 SUBACK - 订阅 确认 


服务 端 发 送 SUBACK 报 文 给 客户 端 ， 用 于 确认 它 已 收 到 并 且 正 在 处 理 SUBSCRIBE 报 文 。 


SUBACK 报 文 包 含 一 个 返回 码 清 单 ， 它 们 指定 了 SUBSCRIBE 请 求 的 每 个 订阅 被 授予 的 最 大 
QoS 等 级 。 


3.9.1 固定 报头 


图 例 3.24 - SUBACK 报 文 固定 报头 


Bit 7 6 5 4 3 2 1 0 
ee MQTT 控 制 报 文 类 型 (9) 保留 位 
1 0 0 1 0 0 0 0 
byte 2 剩余 长 度 


等 于 可 变 报头 的 长 度 加 上 有 效 载 荷 的 长 度 。 
3.9.2 可 变 报 头 


可 变 报 头 包含 等 待 确认 的 SUBSCRIBE 报 文 的 报 文 标识 符 。 图 例 3.25 - SUBACK 报 文 可 变 报 
头 描述 了 可 变 报头 的 格式 。 


图 例 3.25 - SUBACK 报 文 可 变 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 报 文 标 识 符 MSB 
byte 2 报 文 标识 符 LSB 


3.9.3 有 效 载荷 


有 效 载荷 包含 一 个 返回 码 清 单 。 每 个 返回 码 对 应 等 待 确 认 的 SUBSCRIBE 报 文中 的 一 个 主题 过 
滤器 。 返 回 码 的 顺序 必须 和 SUBSCRIBE 报 文中 主题 过 滤器 的 顺序 相同 [MQTT-3.9.3-1]。 


图 例 3.26 ~ SUBACK 报 文 有 效 载 荷 格 式 描述 了 有 效 载 荷 中 单字 节 编 码 的 返回 码 字 段 。 


图 例 3.26 - SUBACK 报 文 有 效 载荷 格式 


Bit 7 6 5 4 3 2 1 0 


byte 1 X 0 0 0 0 0 X X 


允许 的 返回 码 值 : 


。 0x00 - 最 大 QoS 0 

e。 0x01 - 成 功 一 最 大 QoS 1 
e。 0x02 - 成 功 一 最 大 QoS 2 
e。 0x80 - Failure 失败 


0x00, 0x01, 0x02, 0x80 之 外 的 SUBACK 返 回 码 是 保留 的 ， 不 能 使 用 [MQTT-3.9.3-2] 。 


有 效 载 荷 非 规范 示例 


图 例 3.27 -有 效 载荷 字 节 格式 非 规范 示例 展示 了 在 表格 3.6 -有 效 载荷 非 规范 示例 简要 
描述 的 SUBACK 报 文 的 有 效 载荷 。 


表格 3.6 -有 效 载 荷 非 规 范 示例 
Success - Maximum QoS 0 0 


Success - Maximum QoS 2 2 


Failure 


图 例 3.27 -有 效 载 荷 字 节 格 式 非 规范 示例 


首 述 7 6 5 4 3 2 1 
byte 1 Success - Maximum QoS 0 0 0 0 0 0 0 0 
byte 2 Success - Maximum QoS 2 0 0 0 0 0 0 1 
byte 3 Failure 1 0 0 0 0 0 0 
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3.10 UNSUBSCRIBE -取消 订阅 
客户 端 发 送 UNSUBSCRIBE 报 文 给 服务 端 ， 用 于 取消 订阅 主题 。 


3.10.1 固定 报头 


图 例 3.28 - UNSUBSCRIBE 报 文 固定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (10) 保留 位 
1 0 1 0 0 0 1 0 
byte 2 剩余 长 度 


UNSUBSCRIBE 报 文 国定 报头 的 第 3,2,1,0 位 是 保留 位 且 必 须 分 别 设置 为 0,0,1,0。 服 务 端 必须 
认为 任何 其 它 的 值 都 是 不 合法 的 并 关闭 网 络 连接 [MQTT-3.10.1-1]。 


剩余 长 度 字 段 

等 于 可 变 报 头 的 长 度 加 上 有 效 载 荷 的 长 度 。 

3.10.2 可 变 报头 

可 变 报 头 包 含 一 个 报 文 标识 符 。2.3.1 节 提供 了 有 关 报 文 标识 符 的 更 多 信息 。 


图 例 3.29 - UNSUBSCRIBE 报 文 可 变 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 报 文 标识 符 MSB 
byte 2 报 文 标识 符 LSB 


3.10.3 有 效 载荷 


UNSUBSCRIBE 报 文 的 有 效 载荷 包含 客户 
UNSUBSCRIBE 报 文中 的 主题 过 滤器 必须 
串 [MQTT-3.10.3-1] 。 


端 想 要 取消 订阅 的 主题 过 滤器 列表 。 
是 连续 打包 的 、 按 照 1.5.3 节 定义 的 UTF-8 编 码 字 符 


UNSUBSCRIBE 报 文 的 有 效 载 荷 必 须 至 少 包 含 一 个 消息 过 滤器 。 没 有 有 效 载荷 的 
UNSUBSCRIBE 报 文 是 违反 协议 的 [MQTT-3.10.3-2]。 有 关 错 误 处 理 的 更 多 信息 请 查看 4.8 


-二 


T O 


有 效 载 荷 非 规范 示例 


图 例 3.30 -有 效 载 荷 字 节 格式 非 规范 示例 展示 了 表格 3.7 -有 效 载荷 非 规范 示例 简要 描 
述 的 UNSUBSCRIBE 报 文 的 有 效 载荷 。 


表格 3.7 -有 效 载荷 非 规范 示例 


主题 过 滤器 “alb” 


主题 过 滤器 “Cc/d” 


图 例 3.30 -有 效 载荷 字 节 格式 非 规范 示例 


描述 7 6 5 4 3 2 1 0 
主题 过 滤器 
byte 1 Length MSB (0) 0 0 0 0 0 0 0 0 
byte 2 Length LSB (3) 0 0 0 0 0 0 1 1 
byte 3 ‘a’ (0x61) 0 1 1 0 0 0 0 1 
byte 4 ‘7 (Ox2F) 0 0 1 0 1 1 1 1 
byte 5 ‘b’ (0x62 ) 0 1 1 0 0 0 1 0 
主题 过 滤器 
byte 6 Length MSB (0) 0 0 0 0 0 0 0 0 
byte 7 Length LSB (3) 0 0 0 0 0 0 1 1 
byte 8 C (0x63) 0 1 1 0 0 0 1 1 
byte 9 ‘7 (Ox2F) 0 0 1 0 1 1 1 1 
byte 10 ‘d’ (0x64) 0 1 1 0 0 1 0 0 

3.10.4 响应 


UNSUBSCRIBE 报 文 提供 的 主题 过 滤器 (无论 是 否 包含 通配符 ) 必须 人 
端的 当前 主题 过 滤器 集合 逐个 字符 比较 。 如 果 有 任何 过 滤器 完全 匹配 ， 那 么 它 (服务 端 ) 
己 的 订阅 将 被 删除 ， 否 则 不 会 有 进一步 的 处 理 [MQTT-3.10.4-1]。 


如 果 服 务 端 删除 了 一 个 订阅 : 


。 它 必须 停止 分 发 任何 新 消息 给 这 个 客户 端 [MQTT-3.10.4-2] 。 
。 它 必须 完成 分 发 任何 已 经 开始 往 客户 端 发 送 的 QoS 1 和 QoS 2 的 消息 [MQTT-3.10.4-3] 。 
。 它 可 以 继续 发 送 任何 现存 的 准备 分 发 给 客户 端的 缓存 消息 。 


服务 端 必 须发 送 UNSUBACK 报 文 响应 客户 端的 UNSUBSCRIBE 请 求 。UNSUBACK 报 文 必 须 
包含 和 UNSUBSCRIBE 报 文 相 同 的 报 文 标识 符 [MQTT-3.10.4-4]。 即 使 没有 删除 任何 主题 订 
阅 ， 服 务 端 也 必须 发 送 一 个 UNSUBACK 响 应 [MQTT-3.10.4-5]。 


如 果 服 务 端 收 到 包含 多 个 主题 过 滤器 的 UNSUBSCRIBE 报 文 ， 它 必须 如 同 收 到 了 一 系列 的 多 
个 UNSUBSCRIBE 报 文 一 样 处 理 那个 报 文 ， 除 了 将 它们 的 响应 合并 到 一 个 单独 的 UNSUBACK 
报 文 外 。[MQTT-3.10.4-6] 。 
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3.11 UNSUBACK -取消 订阅 确认 


服务 端 发 送 UNSUBACK 报 文 给 客户 端 用 于 确认 收 到 UNSUBSCRIBE 报 文 。 


3.11.1 固定 报头 


图 例 3.31- UNSUBACK 报 文 国定 报头 


Bit 7 6 5 4 
byte 1 MQTT 控 制 报 文 类 型 (11) 保留 位 
1 0 | 
byte 2 剩余 长 度 (2) 
0 0 0 0 
Bit 7 6 5 4 3 
byte 1 MQTT 控 制 报 文 类 型 (11) 
1 0 1 1 0 
byte 2 剩余 长 度 (2) 
0 0 0 0 0 


3.11.2 可 变 报 头 
可 变 报 头 包 含 等 待 确认 的 UNSUBSCRIBE 报 文 的 报 文 标识 符 。 


图 例 3.32 - UNSUBACK 报 文 可 变 报 头 


Bit 7 6 5 4 
byte 1 报 文 标识 符 MSB 
byte 2 报 文 标识 符 LSB 
Bit 7 6 5 4 3 
byte 1 报 文 标识 符 MSB 


byte 2 报 文 标识 符 LSB 


3.11 UNSUBACK - 取消 订阅 确认 


3.11.3 有 效 载荷 


UNSUBACK 报 文 没有 有 效 载荷 。 
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3.12 PINGREQ -- 心跳 请 : 


客户 端 发 送 PINGREQ 报 文 给 服务 端的 。 用 于 : 


1， 在 没有 任何 其 它 控制 报 文 从 客户 端 发 给 服务 的 时 ， 告 知 服务 端 客户 端 还 活着 。 
2. 请 求 服 务 端 发 送 响应 确认 它 还 活着 。 
3. 使 用 网 络 以 确认 网 络 连 接 没 有 断 开 。 


保持 连接 (Keep Alive) 处 理 中 用 到 这 个 报 文 ， 详 细 信 息 请 查看 3.1.2.10 节 。 


3.12.1 固定 报头 


图 例 3.33 - PINGREQ 报 文 国定 报头 


Bit 7 6 5 4 3 2 
byte 1 MQTT 控 制 报 文 类 型 (12) 保留 位 
1 1 0 0 0 0 
byte 2 剩余 长 度 (0) 
0 0 0 0 0 0 
Bit 7 6 5 4 3 2 1 
byte 1 MQTT 控 制 报 文 类 型 (12) 保留 位 
1 1 0 0 0 0 0 
byte 2 剩余 长 度 (0) 
0 0 0 0 0 0 


3.12.2 可 变 报头 
PINGREQ 报 文 没 有 可 变 报头 。 
3.12.3 有 效 载荷 
PINGREQ 报 文 没有 有 效 载荷 。 


3.12.4 响应 


服务 端 必 须发 送 PINGRESP 报 文 响应 客户 端的 PINGREQ 报 文 [MQTT-3.12.4-1] 。 


3.12 PINGREQ -- 心跳 请 求 
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3.13 PINGRESP -心跳 响应 


服务 端 发 送 PINGRESP 报 文 响 应 客户 端的 PINGREQ 报 文 。 表 示 服 务 端 还 活着 。 


保持 连接 (Keep Alive) 处 理 中 用 到 这 个 报 文 ， 详 情 请 查看 3.1.2.10 节 。 


3.13.1 固定 报头 


图 例 3.34 -PINGRESP 报 文 固定 报头 


Bit 7 6 5 4 3 2 
byte 1 MQTT 控 制 报 文 类 型 (13) 保留 位 
1 1 0 1 0 0 
byte 2 剩余 长 度 (0) 
0 0 0 0 0 0 


3.13.2 可 变 报头 


PINGRESP 报 文 没有 可 变 报头 。 


3.13.3 有 效 载荷 


PINGRESP 报 文 没有 有 效 载 荷 。 
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。 3.14 DISCONNECT - 断 开 连接 
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3.14 DISCONNECT -- 断 开 和 连接 


DISCONNECT 报 文 是 客户 端 发 给 服务 端的 最 后 一 个 控制 报 文 。 表 示 端正 常 断 开 连 接 。 


3.14.1 固定 报头 


图 例 3.35 - DISCONNECT 报 文 国定 报头 


Bit 7 6 5 4 3 2 1 0 
byte 1 MQTT 控 制 报 文 类 型 (14) 保留 位 
1 1 1 0 0 0 0 0 
byte 2 剩余 长 度 (0) 
0 0 0 0 0 0 0 0 
服务 端 必须 验证 所 有 的 保留 位 都 被 设置 为 0， 如 果 它 们 不 为 0 必须 断 开 连 接 [MQTT-3.14.1-1]。 


3.14.2 可 变 报头 


DISCONNECT 报 文 没有 可 变 报 头 。 


3.14.3 有 效 载荷 


DISCONNECT 报 文 没 有 有 效 载荷 。 


3.14.4 响应 
客户 端 发 送 DISCONNECT 报 文 之 后 : 


。 必须 关闭 网 络 连 接 [MQTT-3.14.4-1]。 
e 不 能 通过 那个 网 络 连 接 再 发 送 任何 控制 报 文 [MQTT-3.14.4-2] 。 


服务 端 在 收 到 DISCONNECT 报 文 时 : 


。 必须 丢弃 任何 与 当前 连接 关联 的 未 发 布 的 遗嘱 消息 ， 具 体 描 述 见 3.1.2.5 节 [MQTT- 
3.14.4-3] 。 
。 应 该 关闭 网 络 连接 ， 如 果 客 户 端 还 没有 这 么 做 。 


第 三 草 目 录 MQTT 控 制 报 文 
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3.12 PINGREQ - 心跳 请 求 

3.13 PINGRESP 一 心跳 响应 

3.14 DISCONNECT -- 断 开 连 接 
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大 大 


第 四 

目录 

e 第 一 章 - 介绍 

。 第 二 章 一 MQTT 控 制 报 文 格式 
e。 第 三 章 一 MQTT 控 制 报 文 

e 第 四 章 一 操作 行为 

e@ 第 五 章 一 安全 

e 第 六 章 一 使 用 WebSocket 


第 七 章 一 一 致 性 目标 
附录 B - 强制 性 规范 声明 


4.1 状态 存储 Storing state 


章 操作 行为 Operational behavior 


为 了 提供 服务 质量 保证 ， 客 户 端 和 服务 端 有 必要 存储 会 话 状态 。 在 整个 会 话 期 间 ， 客 户 端 和 


务 端 都 必须 存储 会 话 状态 [MQTT-4.1.0-1] 。 
的 时 间 [MQTT-4.1.0-2] 。 


服务 端的 保留 消息 不 是 会 话 状态 的 组 成 部 分 


会 话 必 须 至 


。 服 务 


少 持 续 和 它 的 活跃 网 络 连接 同样 长 


端 应 该 保留 那 种 消息 直到 客户 端 删除 它 。 


非 规范 评注 


客户 端 和 服务 端 实现 的 存储 容量 必然 是 有 限 的 ， 还 可 能 要 受 管理 策略 的 限制 ， 比 如 跨 网 
络 连接 的 会 话 状态 的 最 大 存储 时 间 。 已 保存 的 会 话 状态 丢失 可 能 是 菜 个 管理 操作 造成 
的 ， 例 如 对 某 个 预定 义 条 件 的 自动 响应 。 它 造成 的 后 果 就 是 会 话 终止 。 这 些 操作 可 能 是 
资源 限制 或 其 他 操作 原因 引发 的 。 需 要 说 惯 的 评估 客户 端 和 服务 端的 存储 容量 ， 以 确保 
存储 空间 够 用 。 


非 规范 评注 
客户 端 或 服务 端的 软 硬 件 故障 都 可 能 导致 会 话 状态 的 丢失 或 损坏 。 
非 规 范 评注 


服务 器 和 客户 端 操 作 正 常 可 能 意味 着 ， 已 保存 的 状态 丢失 或 损坏 是 管理 操作 或 软 硬 件 故 
障 造 成 的 。 管 理 操作 可 能 是 对 某 个 预定 义 条 件 的 自动 响应 。 这 些 操 作 可 能 是 资源 限制 或 
其 他 操作 原因 引发 的 。 例 如 ， 服 务 端 可 能 会 基于 外 部 条 件 ， 决 定 不 再 将 某 个 消息 或 某 些 
消息 分 发 给 任何 当前 的 或 以 后 的 客户 端 。 


非 规 范 评注 


MQTT 用 户 应 该 评估 MQTT 客 户 端 和 服务 端 实现 的 存储 容量 ， 确 保 能 满足 需求 。 


非 规范 示例 


例如 ， 想 要 收集 电表 读数 的 用 户 可 能 会 决定 使 用 QoS 1 等 级 的 消息 ， 因 为 他 们 不 能 接受 数据 在 
网 络 传输 途中 丢失， 但 是 ， 他 们 可 能 认为 客户 端 和 服务 端的 数据 可 以 存储 在 内 存 〈 易 失 性 存 
储 器 ) 中 ， 因 为 (他们 觉得 ) 电力 供应 是 非常 可 靠 的 ， 不 会 有 太 大 的 数据 丢失 风险 。 


与 之 相反 ， 停 车 计 费 支付 应 用 的 提供 商 可 能 决定 任何 情况 下 都 不 能 让 数据 支付 消息 丢失 ， 
此 他 们 要 求 在 通过 网 络 传 输 之 前 ， 所 有 的 数据 必须 写 入 到 非 匈 失 性 存储 器 中 (如 硬盘 ) 。 


4.2 网 络 连 接 Network Connections 
MQTT 协 议 要 求 基 础 传输 层 能 够 提供 有 序 的 、 可 靠 的 、 双 向 传输 (从 客户 端 到 服务 端 和 从 服 
务 端 到 客户 端 ) 的 字 节 流 。 

非 规范 评注 

MQTT 3.1 使 用 的 传输 层 协 议 是 [RFC793] 定义 的 TCP/IP 协 议 。 下 面 的 协议 也 支持 : 


。 TLS 协 议 [RFC5246] 
。 WebSocket 协 议 [RFC6455] 


O 
AI 


非 规范 评注 


TCP 端 口 8883 和 1883 已 在 IANA 注册 ， 分 别 用 于 MQTT 的 TLS 和 非 TLS 通 信 。 


无 连接 的 网 络 传输 协议 如 UDP 是 不 支持 的 ， 因 为 他 们 可 能 会 丢失 数据 包 或 对 数据 包 重 排序 。 


4.3 服务 质量 等 级 和 协议 流程 QoS 


MQTT 按 照 这 里 定义 的 服务 质量 (QoS) 等 级 分 发 应 用 消息 。 分 发 协议 是 对 称 的 ， 在 下 面 的 描 
述 中 ， 客 户 端 和 服务 端 既 可 以 是 发 送 者 也 可 以 是 接收 者 。 分 发 协议 关注 的 是 从 单个 发 送 者 到 
单个 接收 者 的 应 用 消息 。 服 务 端 分 发 应 用 消息 给 多 个 客户 端 时 ， 每 个 客户 端 独立 处 理 。 分 发 
给 客户 端的 出 站 应 用 消息 和 入 站 应 用 消息 的 QoS 等 级 可 能 是 不 同 的 。 


下 面 的 非 规范 流程 图 展示 了 可 能 的 实现 方法 。 


4.3.1 QoS 0: 最 多 分 发 一 次 
消息 的 分 发 依赖 于 底层 网 络 的 能 力 。 接 收 者 不 会 发 送 响 应 ， 发 送 者 也 不 会 重 试 。 消 息 可 能 送 
达 一 次 也 可 能 根本 没 送 达 。 
对 于 QoS 0 的 分 发 协议 ， 发 送 者 
。 必须 发 送 QoS 等 于 0，DUP 等 于 0 的 PUBLISH 报 文 [MQTT-4.3.1-1]。 
对 于 QoS 0 的 分 发 协议 ， 接 收 者 
。 接受 PUBLISH 报 文 时 同时 接受 消息 的 所 有 权 。 
图 例 4.1 一 QoS 0 协议 流程 图 ， 非 规范 示例 


发 送 者 动作 控制 报 文 接收 者 动作 
PUBLISH 报 文 QoS 0, DUP=0 


分 发 应 用 消息 给 适当 的 后 续 接收 者 ( 们 ) 


4.3.2 QoS 1: 至 少 分 发 一 次 

服务 质量 确保 消息 至 少 送 达 一 次 。QoS 1 的 PUBLISH 报 文 的 可 变 报 头 中 包含 一 个 报 文 标识 
符 ， 需 要 PUBACK 报 文 确认 。2.3.1 节 提供 了 有 关 报 文 标识 符 的 更 多 信息 。 

对 于 QoS 1 的 分 发 协议 ， 发 送 者 


。 每 次 发 送 新 的 应 用 消息 都 必须 分 配 一 个 未 使 用 的 报 文 标识 符 。 
发 送 的 PUBLISH 报 文 必须 包含 报 文 标识 符 且 QoS 等 于 1，DUP 等 于 0。 


。 必须 将 这 个 PUBLISH 报 文 看 作 是 未 确认 的 ， 直 到 从 接收 者 那 收 到 对 应 的 PUBACK 报 
文 。4.4 节 有 一 个 关于 未 确认 消息 的 讨论 。 


[MQTT-4.3.2-1]. 

一 旦 发 送 者 收 到 PUBACK 报 文 ， 这 个 报 文 标识 符 就 可 以 重用 。 
注意 : 允许 发 送 者 在 等 待 确认 时 使 用 不 同 的 报 文 标识 符 发 送 后 续 的 PUBLISH 报 文 。 
对 于 QoS 1 的 分 发 协议 ， 接 收 者 


e 响应 的 PUBACK 报 文 必 须 包 含 一 个 报 文 标识 符 ， 这 个 标识 符 来 自 接收 到 的 、 已 经 接受 所 
有 权 的 PUBLISH 报 文 。 

。 发 送 了 PUBACK 报 文 之 后 ， 接 收 者 必须 将 任何 包含 相同 报 文 标识 符 的 入 站 PUBLISH 报 文 
当 作 一 个 新 的 消息 ， 并 忽略 它 的 DUP 标 志 的 值 。 


[MQTT-4.3.2-2]. 


图 例 4.2 - QoS 1 协议 流程 图 ， 非 规范 示例 


发 送 者 动作 0 接收 者 动作 

存储 消息 

发 送 PUBLISH 报 文 QoS=1, DUP=0， 带 报 -~ 

文 标识 符 -> 

开始 应 用 消息 的 后 续 分 发 1 

和 发 送 PUBACK 报 文 ， 带 报 文 标 
可 识 符 

丢弃 消息 


Oe nd et 分 发 应 用 消息 。 原 来 的 发 送 者 收 到 PUBACK 报 文 
之 后 ， 应 用 消息 的 所 有 权 就 会 转移 允 个 接收 者 。 


4.3.3 QoS 2: 仅 分 发 一 次 


这 是 最 高 等 级 的 服务 质量 ， 消 息 丢 失 和 重复 都 是 不 可 接受 的 。 使 用 这 个 服务 质量 等 级 会 有 额 
外 的 开销 。 


加 


QoS 2 的 消息 可 变 报头 中 有 报 文 标识 符 。2.3.1 节 提供 了 有 关 报 文 标识 符 的 更 多 信息 。QoS 2 的 


PUBLISH 报 文 的 接收 者 使 用 一 个 两 步 确认 过 程 来 确认 收 到 。 
对 于 QoS 2 的 分 发 协议 ， 发 送 者 


。 必须 给 要 发 送 的 新 应 用 消息 分 配 一 个 未 使 用 的 报 文 标识 符 。 
。 发 送 的 PUBLISH 报 文 必须 包含 报 文 标识 符 且 报 文 的 QoS 等 于 2,，DUP 等 于 0 。 


。 必须 将 这 个 PUBLISH 报 文 看 作 是 未 确认 的 ， 直 到 从 接收 者 那 收 到 对 应 的 PUBREC 报 
文 。4.4 节 有 一 个 关于 未 确认 消息 的 讨论 。 

。 收 到 PUBREC 报 文 后 必须 发 送 一 个 PUBREL 报 文 。PUBREL 报 文 必 须 包 含 与 原始 
PUBLISH 报 文 相同 的 报 文 标识 符 。 

。 必须 将 这 个 PUBREL 报 文 看 作 是 未 确认 的 ， 直 到 从 接收 者 那 收 到 对 应 的 PUBCOMP 报 
文 oO 

e 一 旦 发 送 了 对 应 的 PUBREL 报 文 就 不 能 重 发 这 个 PUBLISH 报 文 。 


[MQTT-4.3.3-1]. 

一 旦 发 送 者 收 到 PUBCOMP 报 文 ， 这 个 报 文 标识 符 就 可 以 重用 。 
注意 : 允许 发 送 者 在 等 待 确认 时 使 用 不 同 的 报 文 标识 符 发 送 后 续 的 PUBLISH 报 文 。 
对 于 QoS 2 的 分 发 协议 ， 接 收 者 


e 响应 的 PUBREC 报 文 必 须 包 含 报 文 标识 符 ， 这 个 标识 符 来 自 接收 到 的 、 已 经 接受 所 有 权 
的 PUBLISH 报 文 。 

e 在 收 到 对 应 的 PUBREL 报 文 之 前 ， ee 卖 的 具有 相 
同 标识 符 的 PUBLISH 报 文 。 在 这 种 情况 下 ， 它 不 能 重复 分 发 消息 给 任何 后 续 的 接收 者 。 

e 响应 PUBREL 报 文 的 PUBCOMP 报 文 必须 包含 与 PUBREL 报 同 的 标识 符 。 

。 发 送 PUBCOMP 报 文 之 后 ， 接 收 者 必须 将 包含 相同 报 文 标识 符 的 任何 后 续 PUBLISH 报 文 
当 作 一 个 新 的 发 布 。 


[MQTT-4.3.3-2]. 


图 例 4.3 - QoS 2 协议 流程 图 ， 非 规范 示例 


发 送 者 动作 接收 者 动作 
文 


存储 消息 


发 送 PUBLISH 报 文 ，QoS=2， 
DUP=0， 带 报 文 标识 符 


-=> 
方法 A : 存储 消息 ， 或 方法 B : 存储 报 文 标识 
符 ， 然 后 开始 向 前 分 发 这 个 应 用 消息 。 
发 送 PUBREC 报 文 ， 带 报 文 标识 符 。 
丢弃 消息 ， 存储 PUBREC 中 
的 报 文 标识 符 
发 送 PUBREL 报 文 ， 带 报 文 标 
识 符 
-—> 
方法 A : 开始 向 前 分 发 应 用 消息 1 然后 丢弃 消息 
或 方法 B : 丢弃 报 文 标识 符 
发 送 PUBCOMP 报 文 ， 带 报 文 标识 符 
ee 
丢弃 已 保存 的 状态 


1 不 要 求 接收 者 在 发 送 PUBREC 或 PUBCOMP 之 前 完整 分 发 应 用 消息 。 原 来 的 发 送 者 收 
到 PUBREC 报 文 之 后 ， 应 用 消息 的 所 有 权 就 会 转移 给 这 个 接收 者 。 


图 例 4.3 一 QoS 2 协议 流程 图 ， 非 规范 示例 展示 了 接收 者 对 QoS 2 等 级 消息 的 两 种 处 理 方 
法 。 他 们 的 区 别 是 消息 什么 时 候 可 以 开始 分 发 。 实 现 者 可 以 决定 使 用 哪 种 方法 。 只 要 实 
现 者 只 选择 了 一 种 方法 ， 就 不 会 影响 QoS 流程 的 可 靠 性 。 


4.4 消息 分 发 重 试 Message delivery retry 


客户 端 设置 清理 会 话 〈CleanSession) 标志 为 0 重 连 时 ， 客 户 端 和 服务 端 必 须 使 用 原始 的 报 文 
标识 符 重 发 任何 未 确认 的 PUBLISH 报 文 (如 果 QoS>0) 和 PUBREL 报 文 [MQTT-4.4.0-1]。 这 
是 唯一 要 求 客 户 端 或 服务 端 重 发 消息 的 情况 。 


非 规范 评注 


吧 


控制 报 文 的 重 发 曾经 需要 克服 菜 些 陈 昌 TCP 网 络 上 的 数据 丢失 问题 。 部 署 在 那些 环境 中 
的 MQTT 3.1.1 实 现 可 能 仍然 需要 关注 这 个 问题 。 


4.5 消息 收 到 Message receipt 
服务 端 接管 入 站 应 用 消息 的 所 有 权时 ， 它 必须 将 消息 添加 到 订阅 匹配 的 客户 端的 会 话 状态 
中 。 匹 配 规 则 定义 见 4.7 节 [MQTT-4.5.0-1]。 


正常 情况 下 ， 客 户 端 收 到 发 送 给 它 的 订阅 的 消息 。 客 户 端 也 可 能 收 到 不 是 与 它 的 订阅 精确 匹 
配 的 消息 。 如 果 服 务 端 自动 给 客户 端 分 配 了 一 个 订阅 ， 可 能 发 生 这 种 情况 。 正 在 处 理 
UBSUBSCRIBE 请 求 时 也 可 能 收 到 消息 。 客 户 端 必须 按照 可 用 的 服务 质量 (QoS ) 规则 确认 
它 收 到 的 任何 PUBLISH 报 文 ， 不 管 它 选择 是 否 处理 报 文 包含 的 应 用 消息 [MQTT-4.5.0-2] 。 


4.6 消息 排序 Message ordering 


实现 本 章 定 义 的 协议 流程 时 ， 客 户 端 必须 遵循 下 列 规则 : 


e@ 重 发 任何 之 前 的 PUBLISH 报 文 时 ， 必 须 按 原始 PUBLISH 报 文 的 发 送 顺 序 重 发 (适用 于 
QoS 1 和 QoS 2 消息 ) [MQTT-4.6.0-1]。 














。 必须 按照 对 应 的 PUBLISH 报 文 的 顺序 发 送 PUBACK 报 文 (QoS 1 消息 ) [MQTT-4.6.0- 
2] 。 

。 必须 按照 对 应 的 PUBLISH 报 文 的 顺序 发 送 PUBREC 报 文 (QoS 2 消息 ) [MQTT-4.6.0- 
3]。 

。 必须 按照 对 应 的 PUBREC 报 文 的 顺序 发 送 PUBREL 报 文 (QoS 2 消息 ) [MQTT-4.6.0-4] 。 


服务 端 必须 默认 认为 每 个 主题 都 是 有 序 的 。 它 可 以 提供 一 个 管理 功能 或 其 它 机 制 ， 以 允许 将 
一 个 或 多 个 主题 当 作 是 无 序 的 [MQTT-4.6.0-5] 。 


服务 端 处 理发 送 给 有 序 主题 的 消息 时 ， 必 须 按 照 上 面 的 规则 将 消息 分 发 给 每 个 订阅 者 。 此 
外 ， 它 必须 按照 从 客户 端 收 到 的 顺序 发 送 PUBLISH 报 文 给 消费 者 (对 相同 的 主题 和 QoS ) 
[MQTT-4.6.0-6] 。 


非 规 范 评注 


上 面 列 出 的 规则 确保 ， 使 用 QoS 1 发 布 和 订阅 的 消息 流 ， 订 阅 者 按照 消息 发 布 时 的 顺序 
收 到 每 条 消息 的 最 终 副 本 ， 但 是 消息 可 能 会 重复 ， 这 可 能 导致 在 它 的 后 继 消息 之 后 收 到 
某 个 已 经 收 到 消息 的 重 发 版 本 。 例 如 ， 发 布 者 按 顺 序 1,2,3,4 发 送 消 息 ， 订 阅 者 收 到 的 顺 
序 可 能 是 1,2,3,2,3,4。 


如 果 客 户 端 和 服务 端 能 保证 任何 时 刻 最 多 有 一 条 消息 在 传输 中 (in-flight) (在 茶 条 消息 
被 确认 前 不 发 送 后 面 的 那 条 消息 ) ， 那 么 ， 不 会 有 QoS 1 的 消息 会 在 它 的 任何 后 续 消 息 
之 后 收 到 。 例 如， 订阅 者 收 到 的 顺序 可 能 是 1,2,3,3,4， 而 不 是 1,2,3,2,3,4。 将 传输 窗口 
(in-flight window) 设 为 1 意味 着 ， 在 同一 个 主题 上 ， 即 使 发 布 者 发 送 了 一 系列 不 同 QoS 
等 级 的 消息 ， 它 们 的 顺序 也 被 保留 。 


4.7 主题 名 和 主题 过 滤 费 Topic Names and Topic 


Filters 


4.7.1 主题 通配符 Topic wildcards 


主题 层级 (topic level) 分 隔 符 用 于 将 结构 化 引入 主题 名 。 如 果 存 在 分 隔 符 ， 它 将 主题 名 分 割 
为 多 个 主题 层级 topic level 。 


订阅 的 主题 过 滤器 可 以 包含 特殊 的 通配符 ， 允 许 你 一 次 订阅 多 个 主题 。 


主题 过 滤器 中 可 以 使 用 通配符 ， 但 是 主题 名 不 能 使 用 通配符 [MQTT-4.7.1-1] 。 


主题 层级 分 隔 符 Topic level separator 


斜 枉 〈 儿 U+002F ) 用 于 分 割 主 题 的 每 个 层级 ， 为 主题 名 提供 一 个 分 层 结构 。 当 客户 端 订 阅 指 
定 的 主题 过 滤器 包含 两 种 通配符 时 ， 主 题 层 级 分 隔 符 就 很 有 用 了 。 主 题 层 级 分 隔 符 可 以 出 现 
在 主题 过 滤器 或 主题 名 字 的 任何 位 置 。 相 邻 的 主题 层次 分 隔 符 表示 一 个 零 长 度 的 主题 层级 。 


多 层 通 配 符 Multi-level wildcard 


数字 标志 ( 寡 U+0023) 是 用 于 匹配 主题 中 任意 层级 的 通配符 。 多 层 通配符 表示 它 的 父 级 和 任 
意 数量 的 子 层 级 。 多 层 通配符 必须 位 于 它 自己 的 层级 或 者 跟 在 主题 层级 分 隔 符 后 面 。 不 管 哪 
种 情况 ， 它 都 必须 是 主题 过 滤器 的 最 后 一 个 字符 [MQTT-4.7.1-2] 。 

非 规范 评注 


例如 ， 如 果 客 户 端 订阅 主题 “sport/tennis/player1/#”， 它 会 收 到 使 用 下 列 主题 名 发 布 的 消 


户 


县 
大 : 


e。 “Sporttennis/player1 


e。 “Sporttennis/player1/ranking” 
e。 “sport/tennis/player1/score/wimbledon” 


非 规 范 评 注 

e “sport/ 术 也 匹配 单独 的 “sport” ， 因 为 ## 包 括 它 的 父 级 。 
e“ 厅 是 有 效 的 ， 会 收 到 所 有 的 应 用 消息 。 
。“sport/tennis/ 太 也 是 有 效 的 。 

e “sport/tennis#" 是 无 效 的 。 
。“sport/tennis/#/ranking” 是 无 效 的 。 


单 层 通配符 
加 号 (+' U+002B) 是 只 能 用 于 单个 主题 层级 匹配 的 通配符 。 


在 主题 过 滤器 的 任意 层级 都 可 以 使 用 单 层 通配符 ， 包 括 第 一 个 和 最 后 一 个 层级 。 然 而 它 必须 
占据 过 滤器 的 整个 层级 [MQTT-4.7.1-3]。 可 以 在 主题 过 滤器 中 的 多 个 层级 中 使 用 它 ， 也 可 以 
和 多 层 通配符 一 起 使 用 。 


非 规 范 评注 


例如 ，“sport/tennis/+” 匹 配 “sport/tennis/player1” 和 “sport/tennis/player2”， 但 是 不 匹 
配 “sport/tennis/player1/ranking”。 同 时 ， 由 于 单 层 通配符 只 能 匹配 一 个 层级 ，“sport/+” 
不 匹配 “sport” 但 是 却 匹配 “sport/”。 


非 规范 评注 


e。 “+” 是 有 效 的 。 

。“+/tennis/#" 是 有 效 的 。 

e “sport+” 是 无 效 的 。 

。 “sport/+/player1” 也 是 有 效 的 。 

e “finance” 匹配 “+/+” 和 %+”， 但 是 不 匹配 “+”。 


4.7.2 以 $ 开 头 的 主题 Topics beginning with $ 


服务 端 不 能 将 $ 字符 开头 的 主题 名 匹配 通配符 (# 或 +) 开头 的 主题 过 滤器 [MQTT-4.7.2-1]。 服 
务 端 应 该 阻止 客户 端 使 用 这 种 主题 名 与 其 它 客户 端 交换 消息 。 服 务 端 实现 可 以 将 $ 开头 的 主 
题名 用 作 其 他 目的 。 


非 规 范 评注 


。 $SYS/ 被 广泛 用 作 包 含 服务 器 特定 信息 或 控制 接口 的 主题 的 前 级 。 
。 应 用 不 能 使 用 $ 字符 开头 的 主题 。 


非 规范 评注 


。 订阅 #"” 的 客户 端 不 会 收 到 任何 发 布 到 以 “$” 开头 主题 的 消息 。 

。 订阅 “+/monitor/Clients” 的 客户 端 不 会 收 到 任何 发 布 到 “$SYS/monitor/Clients” 的 消息 。 

。 订阅 “$SYS/# 的 客户 端 会 收 到 发 布 到 以 “$SYS/”" 开头 主题 的 消息 。 

。 订阅 “$SYS/monitor/+” 的 客户 端 会 收 到 发 布 到 “$SYS/monitor/Clients” 主题 的 消息 。 

e 如 果 客 户 端 想 同时 接受 以 “$SYS/” 开头 主题 的 消息 和 不 以 $ 开头 主题 的 消息 ， 它 需要 同 
时 订阅 叶 " 和 “$SYSh。 


4.7.3 主题 语义 和 用 法 Topic semantic and usage 
主题 名 和 主题 过 滤器 必须 符合 下 列 规则 : 


e。 所 有 的 主题 名 和 主题 过 滤器 必须 至 少 包含 一 个 字符 [MQTT-4.7.3-1]。 

。 主题 名 和 主题 过 滤器 是 区 分 大 小 写 的 。 

。 主题 名 和 主题 过 滤器 可 以 包含 空格 。 

。 主题 名 或 主题 过 滤器 以 前 置 或 后 置 斜 杠 “1 区分。 

。 只 包含 儿 杠 “/" 的 主题 名 或 主题 过 滤器 是 合法 的 。 

。 主题 名 和 主题 过 滤器 不 能 包含 空 字符 (Unicode U+0000) [Unicode] [MQTT-4.7.3-2] 。 

。 主题 名 和 主题 过 滤器 是 UTF-8 编 码 字符 串 ， 它 们 不 能 超过 65535 字 节 [MQTT-4.7.3-3]。 见 
1.5.3 节 。 


除了 不 能 超过 UTF- 编 码 字符 囊 的 长 度 限制 之 外 ， 主 题名 或 主题 过 滤器 的 层级 数量 没有 其 它 限 
制 。 


匹配 订阅 时 ， 服 务 端 不 能 对 主题 名 或 主题 过 滤器 执行 任何 规范 化 (normalization ) 处 理 ， 不 
能 修改 或 替换 任何 未 识别 的 字符 [MQTT-4.7.3-4]。 主 题 过 滤器 中 的 每 个 非 通配符 层级 需要 乏 
字符 匹配 主题 名 中 对 应 的 层级 才 算 匹 配 成 功 。 


非 规 范 评 注 
使 用 UTF-8 编 码 规则 意味 着 ， 主 题 过 滤器 和 主题 名 的 比较 可 以 通过 比较 编码 后 的 UTF-8 字 
节 或 解码 后 的 Unicode 字 符 
非 规 范 评 注 
e。 “ACCOUNTS” 和 “Accounts” 是 不 同 的 主题 名 。 
e “Accounts payable” 是 合法 的 主题 名 
。“/finance” 和 “finance” 是 不 同 的 。 
如 果 订 阅 的 主题 过 滤器 与 消息 的 主题 名 匹配 ， 应 用 消息 会 被 发 送 给 每 一 个 匹配 的 客户 端 订 
阅 。 主 题 可 能 是 管理 员 在 服务 端 预 先 定义 好 的 ， 也 可 能 是 服务 端 收 到 第 一 个 订阅 或 使 用 那个 


主题 名 的 应 用 消息 时 动态 添加 的 。 服 务 端 也 可 以 使 用 一 个 安全 组 件 有 选择 地 授权 客户 端 使 用 


某 个 主题 资源 。 


4.8 错误 处 理 Handling errors 
除非 男 有 说 明 ， 如 果 服 务 端 或 客户 端 遇 到 了 协议 违规 的 行为 ， 它 必须 关闭 传输 这 个 协议 违规 
控制 报 文 的 网 络 连接 [MQTT-4.8.0-1] 。 


客户 端 或 服务 端 实 现 可 能 会 遇 到 瞬时 错误 (Transient Error) (例如 内 部 缓冲 区 满 了 的 情况 ) 
导致 无 法 成 功 处 理 MQTT 报 文 。 


如 果 客户 端 或 服务 端 处 理 入 站 控制 报 文 时 遇 到 了 瞬时 错误 ， 它 必须 关闭 传输 那个 控制 报 文 的 
网 络 连接 [MQTT-4.8.0-2]。 如 果 服 务 端 发 现 了 瞬时 错误 ， 它 不 应 该 断 开 连接 或 者 执行 任何 对 
其 它 客户 端 有 影响 的 操作 。 


项 目 主 页 


。 MQTT 协 议 中 文 版 


。 第 三 章 - MQTT 控 制 报 文 
e 第 四 章 -操作 行为 
。 第 五 竟 - 安全 


A 


e@ 第 六 章 一 使 用 WebSocket 
e@ 第 七 章 一 一 致 性 目标 
e 附录 B - 强制 性 规范 声明 


5.1 概述 


本 章 的 内 容 仅 供 参考 ， 是 非 规范 化 的 。 然 而 ， 强 烈 推 荐 提供 TLS 的 服务 端 实现 应 该 使 用 TCP 端 
口 8883 (IANA 服务 名 : secure-mqtt) 。 


解决 方案 提供 者 需要 考虑 很 多 风险 。 例 如 : 


。 设备 可 能 会 被 盗用 

。 客户 端 和 服务 端的 静态 数据 可 能 是 可 访问 的 (可 能 会 被 修改 ) 
e 协议 行为 可 能 有 副作用 (如 计时 器 攻击 ) 

。 拒绝 服务 攻击 

。 通信 可 能 会 被 拦截 、 修 改 、 重 定向 或 者 泄露 

。 虚假 控制 报 文 注入 


MQTT 方 案 通 常 部 署 在 不 安全 的 通信 环境 中 。 在 这 种 情况 下 ， 协 议 实 现 通 常 需要 提供 这 些 机 
制 : 


。 用 户 和 设备 身份 认证 

。 服务 端 资源 访问 授权 

。 MQTT 控 制 报 文 和 内 赃 应 用 数据 的 完整 性 校 验 
。 MQTT 控 制 报 文 和 内 嵌 应 用 数据 的 隐私 控制 


作为 传输 层 协 议 ，MQTT 仅 关注 消息 传输 ， 提 供 合 适 的 安全 功能 是 实现 者 的 责任 。 使 用 TLS 
[RFC5246] 是 比较 普遍 的 选择 。 除 了 技术 上 的 安全 问题 外 ， 还 有 地 理 因 素 (例如 美国 欧盟 安 
全 港 原则 [USEUSAFEHARB]) ， 行 业 标 准 (例如 第 三 方 支付 行业 数据 安全 标准 
[PCIDSS]) ， 监 管 方 面 的 考虑 (例如 萨 班 斯 -奥克斯 利 法案 [SARBANES]) 等 问题 。 


5.2 MQTT 解 决 方案 : 安全 和 认证 
MQTT solutions: security and certification 


协议 实现 可 能 想 要 符合 特定 的 工业 安全 标准 ， 如 NIST 网 络 安 全 框架 [NISTCSF] ， 第 三 方 支付 
行业 数据 安全 标准 [PCIDSS] ， 美 国联 邦 信息 处 理 标准 [FIPS1402] 和 NSA 加 密 组 合 B 
[NSAB] 。 


在 MQTT 的 补充 出 版 物 (MQTT and the NIST Framework for Improving Critical 
Infrastructure Cybersecurity [MQTT NIST]) 中 可 以 找到 在 NIST 网 络 安 全 框架 [NISTCSF] 中 
使 用 MQTT 的 指导 。 使 用 行业 证 明 、 独 立 审 计 和 认证 技术 有 助 于 满足 合 规 要 求 。 


5.3 轻 量 级 的 加 蜜 与 受 限 设备 


Lightweight cryptography and constrained devices 
广泛 采用 高 级 加 密 标 准 [AES] 数据 加 密 标 准 [DES] 。 


推荐 使 用 为 受 限 的 低 端 设备 特别 优化 过 的 轻 量 级 加 密 国 际 标 准 ISO 29192 [ISO29192] 。 


5.4 实现 注意 事项 Implementation notes 


实现 和 使 用 MQTT 时 需要 考虑 许多 安全 问题 。 下 面 的 部 分 不 应 该 被 当 作 是 一 个 核对 清单 。 


协议 实现 可 以 实现 下 面 的 一 部 分 或 全 部 : 


5.4.1 客户 端 身份 验证 Authentication of Clients by the Server 


CONNECT 报 文 包含 用 户 名 和 密码 字段 。 实 现 可 以 决定 如 何 使 用 这 些 字段 的 内 容 。 实 现 者 可 
以 提供 自己 的 身份 验证 机 制 ， 或 者 使 用 外 部 的 认证 系统 如 LDAP [RFC4511] 或 OAuth 
[RFC6749] ， 还 可 以 利用 操作 系统 的 认证 机 制 。 


实现 可 以 明文 传递 认证 数据 ， 混 消 那 些 数据 ， 或 者 不 要 求 任何 认证 数据 ， 但 应 该 意识 到 这 会 
增加 中 间 人 攻击 和 重 放 攻 击 的 风险 。5.4.5 节 介绍 了 确保 数据 私密 的 方法 。 


在 客户 端 和 服务 端 之 间 使 用 虚拟 专用 网 (VPN) 可 以 确保 数据 只 被 授权 的 客户 端 收 到 。 
使 用 TLS [RFC5246] 时 ， 服 务 端 可 以 使 用 客户 端 发 送 的 SSL 证 书 验证 客户 端的 身份 。 


实现 可 以 允许 客户 端 通过 应 用 消息 给 服务 端 发 送 赁 证 用 于 身份 验证 。 


5.4.2 客户 端 授 权 Authorization of Clients by the Server 


基于 客户 端 提供 的 信息 如 用 户 名 、 客 户 端 标识 符 (Clientld) 、 客 户 端的 主机 名 或 |P 地 址 ， 或 
者 身份 认证 的 结果 ， 服 务 端 可 以 限制 对 某 些 服务 端 资源 的 访问 。 


5.4.3 服务 端 身份 验证 Authentication of the Server by the 
Client 


MQTT 协 议 不 是 双向 信任 的 ， 它 没有 提供 客户 端 验 证 服务 端 身份 的 机 制 。 


但 是 使 用 TLS [RFC5246] 时 ， 客 户 端 可 以 使 用 服务 端 发 送 的 SSL 证 书 验证 服务 端的 身份 。 从 
单 I|P 多 域名 提供 MQTT 服 务 的 实现 应 该 考虑 RFC6066 [RFC6066] 第 3 节 定 义 的 TLS 的 SNI 扩 
展 。SNI 人 允许 客户 端 告诉 服务 端 它 要 连接 的 服务 端 主机 名 。 


实现 可 以 允许 服务 端 通过 应 用 消息 给 客户 端 发 送 凭证 用 于 身份 验证 。 
在 客户 端 和 服务 端 之 间 使 用 虚拟 专用 网 (VPN ) 可 以 确保 客户 端 连接 的 是 预期 的 服务 器 。 


5.4.4 控制 报 文 和 应 用 消息 的 完整 性 Integrity of Application 
Messages and Control Packets 


应 用 可 以 在 应 用 消息 中 单独 包含 哈 希 值 。 这 样 做 可 以 为 PUBLISH 控 制 报 文 的 网 络 传输 和 静 态 
数据 提供 内 容 的 完整 性 检查 。 


TLS [RFC5246] 提供 了 对 网 络 传输 的 数据 做 完整 性 校 验 的 哈 希 算法 。 
在 客户 端 和 服务 端 之 间 使 用 虚拟 专用 网 (VPN) 连接 可 以 在 VPN 黎 盖 的 网 络 段 提供 数据 完整 
性 检查 。 


5.4.5 控制 报 文 和 应 用 消息 的 保密 性 Privacy of Application 
Messages and Control Packets 


TLS [RFC5246] 可 以 对 网 络 传输 的 数据 加 密 。 如 果 有 效 的 TLS 密 码 组 合 包 含 的 加 密 算 法 为 
NULL ， 那 么 它 不 会 加 密 数 据 。 要 确保 客户 端 和 服务 端的 保密 ， 应 避免 使 用 这 些 密码 组 合 。 


应 用 可 以 单独 加 密 应 用 消息 的 内 容 。 这 可 以 提供 应 用 消息 传输 途中 和 静态 数据 的 私密 性 。 但 
不 能 给 应 用 消息 的 其 它 属 性 如 主题 名 加 密 。 


客户 端 和 服务 端 实现 可 以 加 密 存 储 静 态 数据 ， 例 如 可 以 将 应 用 消息 作为 会 话 的 一 部 分 存储 。 
在 客户 端 和 服务 端 之 间 使 用 虚拟 专用 网 (VPN) 连接 可 以 在 VPN 禾 盖 的 网 络 段 保证 数据 的 私 


密 性 。 


.5.4.6 消息 传输 的 不 可 抵赖 性 Non-repudiation of message 
transmission 


应 用 设计 者 可 能 需要 考虑 适当 的 策略 ， 以 实现 端 到 端的 不 可 抵赖 性 (non-repudiation ) 。 


5.4.7 检测 客户 端 和 服务 端的 盗用 Detecting compromise of 
Clients and Servers 

使 用 TLS [RFC5246] 的 客户 端 和 服务 端 实现 应 该 能 够 确保 ， 初 始 化 TLS [RFC5246] 连接 时 提 
供 的 SSL 证 书 是 与 主机 名 〈 客 户 端 要 连接 的 或 服务 端 将 被 连接 的 ) 关联 的 。 

使 用 TLS [RFC5246] 的 客户 端 和 服务 端 实 现 ， 可 以 选择 提供 检查 证 书 吊 销 列 表 (CRLs 
[RFC5280]) 和 在 线 证 书 状态 协议 (OSCP) [RFC6960] 的 功能 ， 拒 绝 使 用 被 吊销 的 证 书 。 


物理 部 署 可 以 将 防 自 改 硬件 与 应 用 消息 的 特殊 数据 传输 结合 。 例 如 ， 一 个 仪表 可 能 会 内 置 一 
个 GPS 以 确保 没有 在 未 授权 的 地 区 使 用 。IEEE 安 全 设备 认证 [IEEE 802.1AR] 就 是 用 于 实现 
这 个 机 制 的 一 个 标准 ， 它 使 用 加 密 绑 定 标 识 符 验 证 设备 身份 。 


5.4.8 检测 异常 行为 Detecting abnormal behaviors 


服务 端 实现 可 以 监视 客户 端的 行为 ， 检 测 潜在 的 安全 风险 。 例 如 : 


。 重复 的 连接 请 求 

。 重复 的 身份 验证 请 求 

。 连接 的 异常 终止 

。 主题 扫描 (请求 发 送 或 订阅 大 量 主题 ) 

。 发 送 无 法 送 达 的 消息 (没有 订阅 者 的 主题 ) 
e 客户 端 连 接 但 是 不 发 送 数 据 


发 现 违反 安全 规则 的 行为 ， 服 务 端 实 现 可 以 断 开 客户 端 连接 。 


服务 端 实现 检测 不 受 欢 迎 的 行为 ， 可 以 基于 IP 地 址 或 客户 端 标识 符 实 现 一 个 动态 黑 名 单列 


服务 部 署 可 以 使 用 网 络 层 次 控制 (如 果 可 用 ) 实现 基于 IP 地 址 或 其 它 信 息 的 速率 限制 或 黑 名 
单 oo 


5.4.9 其 它 的 安全 注意 事项 Other security considerations 


如 果 客 户 端 或 服务 端的 SSL 证 书 丢失 ， 或 者 我 们 考虑 证 书 被 盗用 或 者 被 吊销 (利用 CRLs 
[RFC5280] 和 OSCP [RFC6960]) 的 情况 。 

客户 端 或 服务 端 验证 凭证 时 ， 如 果 发 现 用 户 名 和 密码 丢失 或 被 盗用 ， 应 该 吊销 或 者 重新 发 
放 。 

在 使 用 长 连接 时 : 


e 客户 端 和 服务 端 使 用 TLS [RFC5246] 时 应 该 允许 重新 协商 会 话 以 确认 新 的 加 密 参 数 ( 替 


换 会 话 密 钥 ， 更 换 密码 组 合 ， 更 换 认 证 凭证 ) 。 
e@ 服务 端 可 以 断 开 客户 端 连 接 ， 并 要 求 他 们 使 用 新 的 凭证 重新 验证 身份 。 


受 限 网 络 上 的 受 限 设备 和 客户 端 可 以 使 用 TLS 会 话 恢复 [RFC5077] 降低 TLS 会 话 重 连 
[RFC5246] 的 成 本 。 


连接 到 服务 端的 客户 端 与 其 它 连接 到 服务 端的 客户 端 之 间 有 一 个 信任 传递 关系 ， 它 们 都 有 权 
在 同一 个 主题 上 发 布 消息 。 


0 使 用 SOCKS 人 代理 Use of SOCKS 


客户 端 实现 应 该 意识 到 某 些 环境 要 求 使 用 SOCKSv5 [RFC1928] 代理 创建 出 站 的 网 络 连接 。 
某 些 MQTT 实 现 可 以 利用 安全 隧道 (如 SSH) 通过 SOCKS 代 理 。 一 个 实现 决定 支持 SOCKS 
时 ， 它 们 应 该 同时 支持 匿名 的 和 用 户 名 密码 i ° ee ， 实 现 应 该 
意识 到 SOCKS 可 能 使 用 明文 认证 ， 因 此 应 该 避免 使 用 相同 的 凭证 连接 MQTT 服 务 器 


5.4.11 安全 配置 文件 Security profiles 


实现 者 和 方案 设计 者 可 能 希望 将 安全 当 作 配置 文件 集合 应 用 到 MQTT 协 议 中 。 下 面 描述 的 是 一 
个 分 层 的 安全 等 级 结构 。 

开放 通信 配置 

使 用 开放 通信 配置 时 ，MQTT 协 议 运 行 在 一 个 没有 内 置 额 外 安全 通信 机 制 的 开放 网 络 上 。 


安全 网 络 通 信 配 置 
使 用 安全 网 络 通信 配置 时 ，MQTT 协 议 运行 在 有 安全 控制 的 物理 或 虚拟 网 络 上 ， 如 VPN 或 物理 
安全 网 络 。 
安全 传输 配置 


使 用 安全 传输 配置 时 ，MQTT 协 议 运行 在 使 用 TLS [RFC5246] 的 物理 或 虚拟 网 络 上 ， 它 提供 
了 身份 认证 ， 完 整 性 和 保密 性 。 


使 用 内 置 的 用 户 名 和 密码 字段 ，TLS [RFC5246] 客户 端 身 份 认 证 可 被 用 于 (或 者 代替 ) 
MQTT 客 户 端 认证 。 


工业 标准 的 安全 配置 


可 以 预料 的 是 ，MQTT 被 设计 为 支持 很 多 工业 标准 的 应 用 配置 ， 每 一 种 定义 一 个 威胁 模型 和 用 
于 定位 威胁 的 特殊 安全 机 制 。 特 殊 的 安全 机 制 推荐 从 下 面 的 方案 中 选择 : 


[NISTCSF] NIST 网 络 安全 框架 [NIST7628] NISTIR 7628 智 能 电网 网 络 安全 指南 [FIPS1402] 
(FIPS PUB 140-2) 加 密 模块 的 安全 要 求 [PCIDSS] PCI-DSS 第 三 方 支付 行业 数据 安全 标准 
[INSAB] NSA 加 密 组 合 B 


项 目 主页 
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第 六 章 使 用 WebSocket 作 为 网 络 


。 第 一 章 - 介绍 

e 第 二 章 一 MQTT 控 制 报 文 格式 
e 第 三 章 一 MQTT 控 制 报 文 

e 第 四 章 一 操作 行为 

@ 第 五 章 一 安全 

e@ 第 六 章 一 使 用 WebSocket 


。 第 七 章 一 一 致 性 目标 
。 附录 B - 强制 性 规范 声明 


如 果 MQTT 在 WebSocket [RFC6455] 连接 上 传输 ， 必 须 满 足下 面 的 条 件 : 


。 MQTT 控 制 报 文 必须 使 用 WebSocket 二 进 制 数据 帧 发 送 。 如 果 收 到 任何 其 它 类 型 的 数据 
帧 ， 接 收 者 必须 关闭 网 络 连接 [MQTT-6.0.0-1] 。 


e 单个 WebSocket 数 据 帧 可 以 包含 多 个 或 者 部 分 MQTT 报 文 。 接 收 者 不 能 假设 MQTT 控 制 报 
文 按 WebSocket 帧 边界 对 齐 [MQTT-6.0.0-2] 。 


户 端 必须 将 字符 串 mqtt 包含 在 它 提供 的 WebSocket 子 协议 列表 里 [MQTT-6.0.0-3]。 
e。 服务 端 选择 和 返回 的 WebSocket 子 协议 名 必须 是 mqtt [MQTT-6.0.0-4] 。 


e 用 于 连接 客户 端 和 服务 器 的 WebSocket URI 对 MQTT 协 议 没 有 任何 影响 。 


6.1 IANA 注意 事项 IANA Considerations 


本 规范 请 求 IANA 在 WebSocket 子 协议 名 条 目下 注册 WebSocket MQTT 子 协议 ， 使 用 下 列 
数据 : 


图 例 6.1 -IANA WebSocket 标 识 符 


子 协议 标识 符 mdtt 
子 协议 通用 名 maqtt 
子 协 议定 义 http://docs.o0asis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html 
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第 七 章 一 致 性 Conformance 


e 第 一 章 - 介绍 

。 第 二 章 一 MQTT 控 制 报 文 格式 
。 第 三 章 一 MQTT 控 制 报 文 

e 第 四 章 一 操作 行为 

e@ 第 五 章 一 安全 

。 第 六 章 一 使 用 WebSocket 


e@ 第 七 章 一 一 致 性 目标 
e。 附录 B - 强制 性 规范 声明 


MQTT 规 范 定义 了 MQTT 客 户 端 实现 和 MQTT 服 务 端 实现 的 一 致 性 要 求 


MQTT 实 现 可 以 同时 是 MQTT 客 户 端 和 MQTT 服 务 端 ? 接受 入 站 连接 和 建立 到 其 它 服务 端的 出 
站 连接 的 服务 端 必须 同时 符合 MQTT 客 户 端 和 MQTT 服 务 端的 要 求 [MQTT-7.0.0-1] 。 


为 了 与 任何 其 它 的 一 致 性 实现 交互 操作 ， 一 致 性 实现 不 能 要 求 使 用 在 本 规范 之 外 定义 的 任何 
扩展 [MQTT-7.0.0-2] 。 


7.1 一 致 性 目标 Conformance Targets 


7.1.1 MQTT 服 务 端 MQTT Server 
一 个 MQTT 服 务 端 只 有 满足 下 面 所 有 的 要 求 才 算 是 符合 本 规 


1， 服务 端 发 送 的 所 有 控制 报 文 的 格式 必须 符合 第 二 章 和 第 三 章 描 述 的 格式 
2. 和 7 节 描 述 的 主题 匹配 规则 。 
3， 满足 下 列 章 节 中 所 有 必须 级 别 的 要 求 ， 明 确 仅 适用 于 对 客户 端的 除外 : 


介绍 


A 


o 第 一 章 一 介绍 

@ 第 二 章 一 MQTT 控 制 报 文 格式 

o 第 三 章 一 MQTT 控 制 报 文 

o 第 四 章 一 操作 行为 

o 第 六 章 一 (如果 MQTT 的 网 络 层 是 WebSocket) 
o 第 七 章 一 一 致 性 目标 


满足 一 致 性 要 求 的 服务 端 作 须 支持 使 用 一 个 或 多 个 底层 传输 协议 ， 只 要 它 提供 有 序 的 、 可 靠 
的 、 双 向 字 节 流 (从 客户 端 到 服务 端 和 从 服务 端 到 客户 端 ) [MQTT-7.1.1-1]。 但 是 一 致 性 并 不 
依赖 于 它 支持 任何 特定 的 传输 协议 。 服 务 端 可 以 支持 第 4.2 节 列 出 的 任何 传输 协议 ， 或 者 任何 
其 它 满足 [MQTT-7.1.1-1] 要 求 的 传输 协议 。 


7.1.2 MQTT 客 户 端 MQTT Client 
一 个 MQTT 客 户 端 只 有 满足 下 面 所 有 的 要 求 才 算是 符合 本 规范 : 


1， 客户 端 发 送 的 所 有 控制 报 文 的 格式 必须 符合 第 二 章 和 第 三 章 描述 的 格式 
2， 满足 下 列 章节 中 所 有 必须 级 别 的 要 求 ， 明 确 仅 适用 于 对 服务 端的 除外 : 


O 第 一 章 一 介绍 

o 第 二 章 一 MQTT 控 制 报 文 格式 

o 第 三 章 一 MQTT 控 制 报 文 

o 第 四 章 一 操作 行为 

o 第 六 章 - (如 果 MQTT 的 网 络 层 是 WebSocket) 
o 第 七 章 一 一 致 性 目标 


满足 一 致 性 要 求 的 客户 端 必 须 支 持 使 用 一 个 或 多 个 底层 传输 协议 ， 只 要 它 提供 有 序 的 、 可 靠 
的 、 双 向 字 节 流 (从 客户 端 到 服务 端 和 从 服务 端 到 客户 端 ) [MQTT-7.1.2-1]。 但 是 一 致 性 并 不 
依赖 于 它 支持 任何 特定 的 传输 协议 。 客 户 端 可 以 支持 第 4.2 节 列 出 的 任何 传输 协议 ， 或 者 任何 
其 它 满足 [MQTT-7.1.2-1] 要 求 的 传输 协议 。 
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。 第 三 章 - 
和 


下 经 


一 MQTT 控 制 报 文 格式 
MQTT 控 制 报 文 

一 操作 行为 

安全 


一 使 用 WebSocket 


e 二 二 一 二 性 四 
e。 附录 B - 强制 性 规范 声明 


这 个 附录 是 非 规范 的 ， 只 作为 本 文档 正文 中 可 以 找到 的 大 量 一 致 性 声明 的 摘要 提供 。 一 致 性 
要 求 的 限制 列表 见 第 七 章 。 


表格 : 强制 性 规范 声明 


声明 序 
号 


[MQTT- 
1.5.3-1] 


[MQTT- 
1.5.3-2] 


[MQTT- 
1.5.3-3] 


[MQTT- 
252 | 


[MQTT- 
2.2.2.2] 


[MQTT- 
S| 


[MQTT- 
2.3.1-2] 


[MQTT- 
2.3.1-3] 


规范 声明 


UTF-8 编 码 字 符 串 中 的 字符 数据 必须 是 按照 Unicode 规 范 [Unicode] 定义 的 和 在 民 
[RFC3629] 中 重申 的 有 效 的 UTF-8 格 式 。 特 别 需要 指出 的 是 ， 这 些 数据 不 能 包含 
U+D800 和 U+DFFF 之 间 的 数据 。 如 果 服 务 端 或 客户 端 收 到 了 一 个 包含 无 效 UTF- 
报 文 ， 它 必须 关闭 网 络 连接 。 


UTF-8 编 码 的 字符 囊 不 能 包含 空 字符 U+0000。 如 果 容 户 端 或 服务 端 收 到 了 一 个 色 
的 控制 报 文 ， 它 必须 关闭 网 络 连 接 。 


UTF-8 编 码 序 列 0XEF 0xBB 0xBF 总 是 被 解释 为 Ut+FEFF ( 零 宽 度 非 换 行 空 白字 各 
出 现在 字符 串 的 什么 位 置 ， 报 文 接 收 者 都 不 能 跳 过 或 者 剥离 它 。 


表格 2.2 中 任何 标记 为 “保留 "的 标志 位 ， 都 是 保留 给 以 后 使 用 的 ， 必 须 设置 为 表 枚 
值 。 


如 果 收 到 非法 的 标志 ， 接 收 者 必须 关闭 网 络 连接 。 


SUBSCRIBE ， ，UNSUBSCRIBE 和 PUBLISH (QoS 大 于 0) 控制 报 文 必须 包 
位 报 文 标识 符 (Packet ldentifier 。 


客户 端 每 次 发 送 一 个 新 的 这 些 类 型 的 报 文 时 都 必须 分 配 一 个 当前 未 使 用 的 报 文 标 
如 果 一 个 客户 端 要 重 发 这 个 特殊 的 控制 报 文 ， 在 随后 重 发 那个 报 文 时 ， 它 必须 使 


识 符 。 当 客户 端 处 理 完 这 个 报 文 对 应 的 确认 后 ， 这 个 报 文 标识 符 就 释放 可 重用 。 
PUBLISH 对 应 的 是 PUBACK ，QoS 2 的 PUBLISH 对 应 的 是 PUBCOMP， 与 SUB: 
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UNSUBSCRIBE 对 应 的 分 别 是 SUBACK 或 UNSUBACK 


发 送 一 个 QoS 0 的 PUBLISH 报 文 时 ， 相 同 的 条 件 也 适用 于 服务 端 。 


QoS 设 置 为 0 的 PUBLISH 报 文 不 能 包含 报 文 标识 符 。 


PUBACK, PUBREC, PUBREL 报 文 必须 包含 与 最 初 发 送 的 PUBLISH 报 文 相 同 的 : 
符 。 


与 [MQTT-2.3.1-6] 类 似 ，SUBACK 和 UNSUBACK 必 须 包 含 在 对 应 的 SUBSCRIB 
UNSUBSCRIBE 报 文中 使 用 的 报 文 标识 符 。 


客户 端 到 服务 端的 网 络 连 接 建 立 后 ， 客 户 端 发 送 给 服务 端的 第 一 个 报 文 必须 是 C( 
文 o 

在 一 个 网 络 连接 上 ， 客 户 端 只 能 发 送 一 次 CONNECT 报 文 。 服 务 端 必须 将 客户 端 
个 CONNECT 报 文 当 作协 议 违 规 处 理 并 断 开 客户 端的 连接 。 


如 果 协 议 名 不 正确 服务 端 可 以 断 开 客 户 端的 连接 ， 也 可 以 按照 菜 些 其 它 规范 继续 
CONNECT 报 文 。 对 于 后 一 种 情况 ， 按 照 本 规范 ， 服 务 端 不 能 继续 处 理 CONNE( 


如 果 发 现 不 支持 的 协议 级 别 ， 服 务 端 必须 给 发 送 一 个 返回 码 为 0x01 (不 支持 的 协 
CONNACK 报 文 响应 CONNECT 报 文 ， 然 后 断 开 客户 端的 连接 。 


服务 端 必须 验证 CONNECT 控 制 报 文 的 保留 标志 位 (第 0 位 ) 是 否 为 0， 如 果 不 为 
客户 端 连 接 。 


如 果 清 理会 话 (CleanSession) 标志 被 设置 为 0， 服 务 端 必须 基于 当前 会 话 (使 ， 
识 符 识 别 ) 的 状态 恢复 与 客户 端的 通信 。 如 果 没 有 与 这 个 客户 端 标 识 符 关联 的 会 
必须 创建 一 个 新 的 会 话 。 在 连接 断 开 之 后 ， 当 连接 断 开 后 ， 客 户 端 和 服务 端 必须 
息 9 


当 清理 会 话 标志 为 0 的 会 话 连接 断 开 之 后 ， 服 务 端 必 须 将 之 后 的 QoS 1 和 QoS 2 名 
存 为 会 话 状态 的 一 部 分 ， 如 果 这 些 消息 匹配 断 开 连接 时 客户 端的 任何 订阅 。 


如 果 清 理会 话 (CleanSession) 标志 被 设置 为 1， 客 户 端 和 服务 端 必须 丢弃 之 前 ! 
并 开始 一 个 新 的 会 话 。 会 话 仅 持续 和 网 络 连 接 同样 长 的 时 间 。 与 这 个 会 话 关联 的 
能 被 任何 之 后 的 会 话 重用 。 


保留 消息 不 是 服务 端 会 话 状态 的 一 部 分 ， 会 话 终止 时 不 能 删除 保留 消息 。 


遗嘱 标志 (Will Flag) 被 设置 为 1， 表 示 如 果 连 接 请 求 被 接受 了 ， 遗 路 (Will Mes 
必须 被 存储 在 服务 端 并 且 与 这 个 网 络 连接 关联 。 之 后 网 络 连接 关闭 时 ， 服 务 端 必 
遗嘱 消息 ， 除 非 服务 端 收 到 DISCONNECT 报 文 时 删除 了 这 个 遗嘱 消息 。 


如 果 遗 嘱 标 志 被 设置 为 1， 连 接 标志 中 的 Will QoS 和 Will Retain 字 段 会 被 服务 端 必 
效 载荷 中 必须 包含 Will Topic 和 Will Message 字 段 。 


一 旦 被 发 布 或 者 服务 端 收 到 了 客户 端 发 送 的 DISCONNECT 报 文 ， 遗 嘱 消 息 就 必 
会 话 状态 中 移 除 。 


如 果 遗 嘱 标 志 被 设置 为 0， 连 接 标志 中 的 Will QoS 和 Will Retain 字 段 必须 设置 为 0 
载荷 中 不 能 包含 Will Topic 和 Will Message 字 段 。 
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[MQTT- 


3.1.2- 如 果 遗 嘱 标 志 被 设置 为 0， 遗 嘱 QoS 也 必须 设置 为 0(0x00)。 
13] 


yl T 如果 遗 唱 标 志 被 设置 为 1， 遗嘱 QoS 的 值 可 以 等 于 0(0x00)，1(0x01)，2(0x02)。 
2 等 于 3。 

[MQTT- 

3.1.2- 如 果 遗 嘱 标 志 被 设置 为 0， 遗 嘱 保 留 〈Will Retain) 标志 也 必须 设置 为 0。 

15] 

[MQTT- 


S02 如 果 遗 嘱 保 留 被 设置 为 0， 服 务 端 必须 将 遗嘱 消息 当 作 非 保留 消息 发 布 。 
16] 

[MQTT- 

3.1.2- 如 果 遗 嘱 保 留 被 设置 为 1， 服 务 端 必须 将 遗嘱 消息 当 作 保留 消息 发 布 。 
17] 
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U2 如 果 用 户 名 (User Name) 标志 被 设置 为 0， 有 效 载荷 中 不 能 包含 用 户 名 字段 。 
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[MQTT- 

3 外 如 果 用 户 名 (User Name) 标志 被 设置 为 1， 有 效 载 荷 中 必须 包含 用 户 名 字段 。 
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[MQTT- 

U23 如 果 密 码 (Password) 标志 被 设置 为 0， 有 效 载 荷 中 不 能 包含 密码 字段 。 

20] 

[MQTT- 

3.1.2- 如 果 密 码 (Password) 标志 被 设置 为 1， 有 效 载 荷 中 必须 包含 密码 字段 

21] 

[MQTT- 

3.1.2- ”如 果 用 户 名 标志 被 设置 为 0， 密码 标志 也 必须 设置 为 0。 

22] 

J 客户 端 负 责 保证 控制 报 文 发 送 的 时 间 间 隔 不 超过 保持 连接 的 值 。 如 果 没 有 任何 其 
23] 文 可 以 发 送 ， 客 户 端 必须 发 送 一 个 PINGREQ 报 文 。 

DS 如 果 保 持 连 接 的 值 非 零 ， 并 且 服 务 端 在 一 点 五 倍 的 保持 连接 时 间 内 没有 收 到 客户 
| 文 ， 它 必须 断 开 客户 端的 网 络 和 连接， 认为 网 络 和 连接 已 断 开 。 


[IMQTT- ”如 果 和 包含 的 话 ， 必 须 按 这 个 顺序 出 现 : 客户 端 标识 符 ， 遗 嘱 主 题 ， 遗 嘱 消 息 ， 用 
3.1.3-1] 码 。 


服务 端 使 用 客户 端 标 识 符 (Clientld) 识别 客户 端 。 连 接 服务 端的 每 个 客户 端 都 有 。 
[MQTT- ” 端 标识 符 (Clientld) 。 客 户 端 和 服务 端 都 必须 使 用 Clientld 识 别 两 者 之 间 的 MQT 


[MQTT- 
3.1.3-3] 


[MQTT- 
3.1.3-4] 


[MQTT- 
3.1.3-5] 


[MQTT- 
3.1.3-6] 


[MQTT- 
3.1.3-7] 


[MQTT- 
3.1.3-8] 


[MQTT- 
3.1.3-9] 


[MQTT- 
S32 
10] 


[MQTT- 
3.1.3- 
11] 


[MQTT- 
3.1.4-1] 


[MQTT- 
3.1.4-2] 


[MQTT- 
3.1.4-3] 


[MQTT- 
3.1.4-4] 


[MQTT- 
3.1.4-5] 


[MQTT- 
3.2.0-1] 


[MQTT- 
3.2.2-1] 


[MQTT- 
3.2.2-2] 


的 状态 。 


客户 端 标 识 符 (Clientld) 必须 存在 而 且 必 须 是 CONNECT 报 文 有 效 载荷 的 第 一 个 * 


客户 端 标 识 符 必须 是 1.5.3 节 定义 的 UTF-8 编 码 字符 囊 。 


服务 端 必 须 允 许 1 到 23 个 字 节 长 的 UTF-8 编 码 的 客户 端 标 识 符 ， 客 户 端 标 识 符 只 角 
符 : “0123456789abcdefghijklImnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTU\ 
写字 母 ， 小 写字 母 和 数字 ) 。 

服务 端 可 以 允许 客户 端 提 供 一 个 零 字 节 的 客户 端 标识 符 (Clientld) ， 如 果 这 样 做 - 
必须 将 这 看 作 特殊 情况 并 分 配 唯一 的 客户 端 标识 符 给 那个 客户 端 。 然 后 它 必 须 假 
供 了 那个 唯一 的 客户 端 标识 符 ， 正 常 处 理 这 个 CONNECT 报 文 。 


如 果 客 户 端 提供 了 一 个 零 字 节 的 客户 端 标识 符 ， 它 必须 同时 将 清理 会 话 标志 设置 
如 果 客 户 端 提供 的 Clientld 为 零 字 节 且 清理 会 话 标 志 为 0， 服 务 端 必 须发 送 返回 码 
示 标 识 符 不 合格 ) 的 CONNACK 报 文 响应 客户 端的 CONNECT 报 文 ， 然 后 关闭 网 


如 果 服 务 端 拒 绝 了 这 个 Clientld， 它 必须 发 送 返 回 码 为 0x02 (表示 标识 符 不 合格 ) 
CONNACK 报 文 响 应 客户 端的 CONNECT 报 文 ， 然 后 关闭 网 络 连 接 。 


遗嘱 主题 必须 是 1.5.3 节 定义 的 UTF-8 编 码 字符 串 。 


用 户 名 必须 是 1.5.3 节 定义 的 UTF-8 编 码 字 符 囊 。 


服务 端 必 须 按照 3.1 节 的 要 求 验证 CONNECT 报 文 ， 如 果 报 文 不 符合 规范 ， 服 务 剖 
CONNACK 报 文 直 接 关 闭 网 络 连 接 。 


如 果 Clientld 表 明 客 户 端 已 经 连接 到 这 个 服务 端 ， 那 么 服务 端 必须 断 开 原 有 的 客 上 
服务 端 必 须 按 照 3.1.2.4 节 的 描述 执行 清理 会 话 的 过 程 。 
服务 端 必 须发 送 返回 码 为 零 的 CONNACK 报 文 作 为 CONNECT 报 文 的 确认 响应 。 


如 果 服 务 端 拒 绝 了 CONNECT， 它 不 能 处 理 客户 端 在 CONNECT 报 文 之 后 发 送 的 
服务 端 发 送 CONNACK 报 文 响应 从 客户 端 收 到 的 CONNECT 报 文 。 服 务 端 发 送 给 
一 个 报 文 必须 是 CONNACK 。 


如 果 服 务 端 收 到 清理 会 话 (CleanSession) 标志 为 1 的 连接 ， 除 了 将 CONNACK: 
回 码 设置 为 0 之 外 ， 还 必须 将 CONNACK 报 文中 的 当前 会 话 设置 (Session Prese 
0 o 

如 果 服 务 端 收 到 一 个 CleanSession 为 0 的 连接 ， 当 前 会 话 标志 的 值 取决 于 服务 端 : 
存 了 Clientld 对 应 客户 端的 会 话 状态 。 如 果 服 务 端 已 经 保存 了 会 话 状态 ， 它 必须 六 
报 文中 的 当前 会 话 标志 设置 为 1。 
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报 文中 的 当前 会 话 标志 设置 为 1。 
如 果 服 务 端 没有 已 保存 的 会 话 状态 ， 它 必须 将 CONNACK 报 文中 的 当前 会 话 设置 
将 CONNACK 报 文中 的 返回 码 设置 为 0。 


如 果 服 务 端 发 送 了 一 个 包含 非 零 返回 码 的 CONNACK 报 文 ， 它 必须 将 当前 会 话 标 


如 果 服 务 端 发 送 了 一 个 包含 非 零 返回 码 的 CONNACK 报 文 ， 那 么 它 必 须 关 闭 网 络 


如 果 认 为 上 表格 3.1 中 的 所 有 连接 返回 码 都 不 太 合适 ， 那 么 服务 端 必须 关闭 网 络 六 
发 送 CONNACK 报 文 。 


客户 端 或 服务 端 请 求 重 发 一 个 PUBLISH 报 文 时 ， 必 须 将 DUP 标 志 设 置 为 1。 


对 于 QoS 0 的 消息 ，DUP 标 志 必 须 设置 为 0 


服务 端 发 送 PUBLISH 报 文 给 订阅 者 时 ， 收 到 (入 站 ) 的 PUBLISH 报 文 的 DUP 标 ， 
被 传播 。 发 送 (出 站 ) 的 PUBLISH 报 文 与 收 到 (入 站 ) 的 PUBLISH 报 文中 的 DU 
立 设置 的 ， 它 的 值 必须 单独 的 根据 发 送 (出 站 ) 的 PUBLISH 报 文 是 否 是 一 个 重 改 


PUBLISH 报 文 不 能 将 QoS 所 有 的 位 设置 为 1。 如 果 服 务 端 或 客户 端 收 到 QoS 所 有 . 
PUBLISH 报 文 ， 它 必须 关闭 网 络 连接 。 


如 果 客 户 端 发 给 服务 端的 PUBLISH 报 文 的 保留 (RETAIN ) 标志 被 设置 为 1， 服 和 
这 个 应 用 消息 和 它 的 服务 质量 等 级 (QoS ) ， 以 便 它 可 以 被 分 发 给 未 来 的 主题 名 
者 o 

一 个 新 的 订阅 建立 时 ， 对 每 个 匹配 的 主题 名 ， 如 果 存 在 最 近 保 留 的 消息 ， 它 必须 
个 订阅 者 。 


如 果 服 务 端 收 到 一 条 保留 (RETAIN ) 标志 为 1 的 QoS 0 消息 ， 它 必须 丢弃 之 前 为 
留 的 任何 消息 。 它 应 该 将 这 个 新 的 QoS 0 消息 当 作 那个 主题 的 新 保留 消息 ， 但 是 . 
可 以 选择 丢弃 它 一 如 果 这 种 情况 发 生 了 ， 那 个 主题 将 没有 保留 消息 。 


服务 端 发 送 PUBLISH 报 文 给 客户 端 时 ， 如 果 消 息 是 作为 客户 端 一 个 新 订阅 的 结果 
须 将 报 文 的 保留 标志 设 为 1。 

当 一 个 PUBLISH 报 文 发 送 给 客户 端 是 因为 匹配 一 个 已 建立 的 订阅 时 ， 服 务 端 必 努 
设 为 0， 不 管 它 收 到 的 这 个 消息 中 保留 标志 的 值 是 多 少 。 


保留 标志 为 1 且 有 效 载荷 为 零 字 节 的 PUBLISH 报 文 会 被 服务 端 当 作 正常 消息 处 理 
送 给 订阅 主题 匹配 的 客户 端 。 此 外 ， 同 一 个 主题 下 任何 现存 的 保留 消息 必须 被 移 
个 主题 之 后 的 任何 订阅 者 都 不 会 收 到 一 个 保留 消息 。 


服务 端 不 能 存储 零 字 节 的 保留 消息 。 
如 果 客 户 端 发 给 服务 端的 PUBLISH 报 文 的 保留 标志 位 0， 服 务 端 不 能 存储 这 个 消 
除 或 替换 任何 现存 的 保留 消息 。 


主题 名 必须 是 PUBLISH 报 文 可 变 报 头 的 第 一 个 字段 。 它 必须 是 1.5.3 节 定义 的 UT 
字符 串 。 


PUBLISH 报 文中 的 主题 名 不 能 包含 通配符 。 


服务 端 发 送 给 订阅 客户 端的 PUBLISH 报 文 的 主题 名 必须 匹配 该 订阅 的 主题 过 滤器 
节 定 义 的 匹配 过 程 ) 。 


PUBLISH 报 文 的 接收 者 必须 按照 根据 PUBLISH 报 文中 的 QoS 等 级 发 送 响应 ， 见 j 
服务 端 必 须 将 消息 分 发 给 所 有 订阅 匹配 的 QoS 等 级 最 高 的 客户 端 。 

如 果 服 务 端 实现 不 授权 某 个 客户 端 发 布 PUBLISH 报 文 ， 它 没有 办 法 通知 那个 客户 
按照 正常 的 QoS 规则 发 送 一 个 正面 的 确认 ， 或 者 关闭 网 络 连接 。 


PUBREL 控 制 报 文 固定 报头 的 第 3,2,1,0 位 是 保留 位 ， 必 须 被 设置 为 0,0,1,0。 服 务 
它 的 任何 值 都 当做 是 不 合法 的 并 关闭 网 络 连 接 。 


SUBSCRIBE 控 制 报 固定 报头 的 第 3,2,1,0 位 是 保留 位 ， 必 须 分 别 设置 为 0,0,1,0。 
将 其 它 的 任何 值 都 当做 是 不 合法 的 并 关闭 网 络 连接 。 
SUBSCRIBE 报 文 有 效 载荷 中 的 主题 过 滤器 列表 必须 是 1.5.3 节 定义 的 UTF-8 字 符 
如 果 服 务 端 选择 不 支持 包含 通配符 的 主题 过 滤器 ， 必 须 拒 绝 任何 包含 通配符 过 滤 
SUBSCRIBE 报 文 的 有 效 载荷 必须 包含 至 少 一 对 主题 过 滤器 和 QoS 等 级 字段 组 侣 
载荷 的 SUBSCRIBE 报 文 是 违反 协议 的 。 


如 果 有 效 载荷 中 的 任何 位 是 非 零 值 ， 或 者 QoS 不 等 于 0,1 或 2， 服 务 端 必 须 认 为 SL 
报 文 是 不 合法 的 并 关闭 网 络 连接 。 


服务 端 收 到 客户 端 发 送 的 一 个 SUBSCRIBE 报 文 时 ， 必 须 使 用 SUBACK 报 文 响应 


SUBACK 报 文 必 须 和 等 待 确认 的 SUBSCRIBE 报 文 有 相同 的 报 文 标识 符 。 


如 果 服 务 端 收 到 一 个 SUBSCRIBE 报 文 ， 报 文 的 主题 过 滤器 与 一 个 现存 订阅 的 主 : 
同 ， 那 么 必须 使 用 新 的 订阅 彻底 替换 现存 的 订阅 。 新 订阅 的 主题 过 滤器 和 之 前 订 
但 是 它 的 最 大 QoS 值 可 以 不 同 。 与 这 个 主题 过 滤器 匹配 的 任何 现存 的 保留 消息 必 
但 是 发 布 流程 不 能 中 断 。 


如 果 服 务 端 收 到 包含 多 个 主题 过 滤器 的 SUBSCRIBE 报 文 ， 它 必须 如 同 收 到 了 一 
SUBSCRIBE 报 文 一 样 处 理 那个 ， 除 了 需要 将 它们 的 响应 合并 到 一 个 单独 的 SUB 
送 o 

服务 端 发 送 给 客户 端的 SUBACK 报 文 对 每 一 对 主题 过 滤器 和 QoS 等 级 都 必须 包公 
码 。 这 个 返回 码 必 须 表示 那个 订阅 被 授予 的 最 大 QoS 等 级 ， 或 者 表示 这 个 订阅 失 


服务 端 可 以 授予 比 订 阅 者 要 求 的 低 一 些 的 QoS 等 级 。 为 响应 订阅 而 发 出 的 消息 的 
QoS 必须 是 原始 发 布 消息 的 QoS 和 服务 端 授予 的 QoS 两 者 中 的 最 小 值 。 如 果 原 始 
是 1 而 被 授予 的 最 大 QoS 是 0， 人 允许 服 务 端 重复 发 送 一 个 消息 的 副本 给 订阅 者 。 


返回 码 的 顺序 必须 和 SUBSCRIBE 报 文中 主题 过 滤器 的 顺序 相同 。 


0x00, 0x01, 0x02, 0x80 之 外 的 SUBACK 返 回 码 是 保留 的 ， 不 能 使 用 。 


UNSUBSCRIBE 报 文 固定 报头 的 第 3,2,1,0 位 是 保留 位 且 必 须 分 别 设置 为 0,0,1,0。 
认为 任何 其 它 的 值 都 是 不 合法 的 并 关闭 网 络 连接 。 


UNSUBSCRIBE 报 文中 的 主题 过 滤器 必须 是 连续 打包 的 、 按 照 1.5.3 节 定义 的 UTI 
串 。 


UNSUBSCRIBE 报 文 的 有 效 载 荷 必 须 至 少 包 含 一 个 消息 过 滤器 。 没 有 有 效 载 荷 芯 
UNSUBSCRIBE 报 文 是 违反 协议 的 。 


UNSUBSCRIBE 报 文 提供 的 主题 过 滤器 (无 论 是 否 包 含 通配符 ) 必须 与 服务 端 持 
户 端的 当前 主题 过 滤器 集合 乏 个 字符 比较 。 如 果 有 任何 过 滤器 完全 匹配 ， 那 么 它 
自己 的 订阅 将 被 删除 ， 否 则 不 会 有 进一步 的 处 理 。 


如 果 服 务 端 删除 了 一 个 订阅 ， 它 必须 停止 分 发 任何 新 消息 给 这 个 客户 端 。 


如 果 服 务 端 删除 了 一 个 订阅 ， 它 必须 完成 分 发 任何 已 经 开始 往 客户 端 发 送 的 QoS 
的 消息 。 


服务 端 必 须发 送 UNSUBACK 报 文 响应 客户 端的 UNSUBSCRIBE 请 求 。UNSUBA 
包含 和 UNSUBSCRIBE 报 文 相 同 的 报 文 标识 符 。 


即使 没有 删除 任何 主题 订阅 ， 服 务 端 也 必须 发 送 一 个 SUBACK 响 应 。 


如 果 服 务 端 收 到 包含 多 个 主题 过 滤器 的 UNSUBSCRIBE 报 文 ， 它 必须 如 同 收 到 了 
个 UNSUBSCRIBE 报 文 一 样 处 理 那 个 报 文 ， 除 了 将 它们 的 响应 合并 到 一 个 单独 芯 
UNSUBACK 报 文 外 。 


服务 端 必须 发 送 PINGRESP 报 文 响应 客户 端的 PINGREQ 报 文 。 


服务 端 必 须 验 证 所 有 的 保留 位 都 被 设置 为 0， 如 果 它 们 不 为 0 必须 断 开 连 接 。 


户 端 发 送 DISCONNECT 报 文 之 后 ， 必 须 关 闭 网 络 连接 。 


啊 


户 端 发 送 DISCONNECT 报 文 之 后 ， 不 能 通过 那个 网 络 连接 再 发 送 任何 控制 报 : 


啊 
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体 描述 见 3.1.2.5 节 。 


在 整个 会 话 期 间 ， 客 户 端 和 服务 端 都 必须 存储 会 话 状态 。 


会 话 必须 至 少 持 续 和 它 的 活跃 网 络 连 接 同样 长 的 时 间 。 


对 于 QoS 0 的 分 发 协议 ， 发 送 者 必须 发 送 QoS 等 于 0，DUP 等 于 0 的 PUBLISH 报 广 
客户 端 设 置 清理 会 话 (CleanSession ) 标志 为 0 重 连 时 ， 客 户 端 和 服务 端 必 须 使 ， 
文 标 识 符 重 发 任何 未 确认 的 PUBLISH 报 文 (如 果 QoS>0) 和 PUBREL 报 文 。 


务 端 接管 入 站 应 用 消息 的 所 有 权时 ， 它 必须 将 消息 添加 到 订阅 匹配 的 客户 端的 
中 。 匹 配 规则 定义 见 4.7 节 。 


客户 端 必须 按照 可 用 的 服务 质量 (QoS) 规则 确认 它 收 到 的 任何 PUBLISH 报 文 ， 
是 否 处 理 报 文 包含 的 应 用 消息 。 


重 发 任何 之 前 的 PUBLISH 报 文 时 ， 必 须 按 原始 PUBLISH 报 文 的 发 送 顺序 重 发 (3 
和 QoS 2 消息 ) 。 


必须 按照 对 应 的 PUBLISH 报 文 的 顺序 发 送 PUBACK 报 文 (QoS 1 消息 ) 。 


必须 按照 对 应 的 PUBLISH 报 文 的 顺序 发 送 PUBREC 报 文 (QoS 2 消息 ) 。 








必须 按照 对 应 的 PUBREC 报 文 的 顺序 发 送 PUBREL 报 文 (QoS 2 消息 ) 。 


服务 端 必 须 默认 认为 每 个 主题 都 是 有 序 的 。 它 可 以 提供 一 个 管理 功能 或 其 它 机 制 
一 个 或 多 个 主题 当 作 是 无 序 的 。 


服务 端 处 理发 送 给 有 序 主题 的 消息 时 ， 必 须 按 照 上 面 的 规则 将 消息 分 发 给 每 个 订 
外 ， 它 必须 按照 从 客户 端 收 到 的 顺序 发 送 PUBLISH 报 文 给 消费 者 (对 相同 的 主 是 


过 滤器 中 可 以 使 用 通配符 ， 但 是 主题 名 不 能 使 用 通配符 。 


多 层 通配符 必须 位 于 它 自己 的 层级 或 者 跟 在 主题 层级 分 隔 符 后 面 。 不 管 哪 种 情况 


是 主题 过 滤器 的 最 后 一 个 字符 。 


在 主题 过 滤器 的 任意 层级 都 可 以 使 用 单 层 通配符 ， 包 括 第 一 个 和 最 后 一 个 层级 。 
占据 过 滤器 已 吕 的 整 发 个 层 级 2 


服务 端 不 能 将 $ 字符 开头 的 主题 名 匹配 通配符 (# 或 +) 开头 的 主题 过 滤器 。 
所 有 的 主题 名 和 主题 过 滤器 必须 至 少 包含 一 个 字符 。 
主题 名 和 主题 过 滤器 不 能 包含 空 字符 (Unicode U+0000) [Unicode] 。 


主题 名 和 主题 过 滤器 是 UTF-8 编 码 字 符 串 ， 它 们 不 能 超过 65535 字 节 。 


[MQTT- ”匹配 订阅 时 ， 服 务 端 不 外 1 或 主题 过 滤器 执行 任何 规范 化 (normalization 
4.7.3-4] ”能 修改 或 替换 任何 未 识别 的 字符 。 

[MQTT- ”除非 男 有 说 明 ， 如 果 服 务 端 或 客户 端 遇 到 了 协议 违规 的 行为 ， 它 必须 关闭 传输 这 
4.8.0-1] ”控制 报 文 的 网 络 连 接 。 

[MQTT- ”如 果 客 户 端 或 服务 端 处 理 入 站 控制 报 文 时 遇 到 了 有 瞬时 错误 ， 它 必须 关闭 传输 那个 
4.8.0-2] ”网 络 连接 。 

[MQTT- ”MQTT 控 制 报 文 必 须 使 用 WebSocket 二 进 制 数据 帧 发 送 。 如 果 收 到 任何 其 它 类 型 
6.0.0-1] ”接收 者 必须 关闭 网 络 连接 。 

[MQTT- ”单个 WebSocket 数 据 帧 可 以 包含 多 个 或 者 部 分 MQTT 报 文 。 接 收 者 不 能 假设 MQIT 
6.0.0-2] ， 按 WebSocket 帧 边界 对 齐 。 

[MQTT- Pr 门 、 山 sj 女人 > 方 生 1 日 计 

6.0.0-3] 客户 端 必 须 将 字符 串 mqtt 包含 在 它 提 供 的 WebSocket 子 协议 列表 里 。 

Re 站 服务 端 选择 和 返回 的 WebSocket 子 协议 名 必须 是 mqtt 

[IMQTT- ”MQTT 实 现 可 以 同时 是 MQTT 客 户 端 和 MQTT 服 务 端 。 接 受 入 站 连接 和 建立 到 其 1 
7.0.0-1] ”站 连接 的 服务 端 作 须 同时 符合 MQTT 客 户 端 和 MQTT 服 务 端 的 要 求 。 

[MQTT- ”为 了 与 任何 其 它 的 一 致 性 实现 交互 操作 ， 一 致 性 实现 不 能 要 求 使 用 在 本 规范 之 外 
7.0.0-2] ”扩展 。 

[MQTT- 满足 一 致 性 要 求 的 服务 端 必 须 支持 使 用 一 个 或 多 个 底层 传输 协议 ， 只 要 它 提供 有 
7.1.1-1] 的、 双向 字 节 流 〈 从 客户 端 到 服务 端 和 从 服务 端 到 客户 端 ) 

[MQTT- 满足 一 致 性 要 求 的 客户 端 必 须 支持 使 用 一 个 或 多 个 底层 传输 协议 ， 只 要 它 提供 有 
7.1.2-1] 的 、 双 向 字 节 流 〈 从 客户 端 到 服务 端 和 从 服务 端 到 客户 端 ) 

关于 QoS 的 补充 说 明 


[MQTT-4.3.2-1] 对 于 QoS 1 的 分 发 协议 ， 发 送 者 


e 每 次 发 送 新 的 应 用 消息 都 必须 分 配 一 个 未 使 用 的 报 文 标识 符 。 

e。 MUST send a PUBLISH Packet containing this Packet Identifier with QoS=1, DUP=0. 

。 发 送 的 PUBLISH 报 文 必 须 包 含 报 文 标识 符 且 QoS 等 于 1，DUP 等 于 0 。 

。 必须 将 这 个 PUBLISH 报 文 看 作 是 未 确认 的 ， 直 到 从 接收 者 那 收 到 对 应 的 PUBACK 报 
文 。4.4 节 有 一 个 关于 未 确认 消息 的 讨论 。 


[MQTT-4.3.2-2] 对 于 QoS 1 的 分 发 协议 ， 接 收 者 


e 响应 的 PUBACK 报 文 必 须 包 含 一 个 报 文 标识 符 ， 这 个 标识 符 来 自 接收 到 的 、 已 经 接受 所 
有 权 的 PUBLISH 报 文 。 

。 发 送 了 PUBACK 报 文 之 后 ， 接 收 者 必须 将 任何 包含 相同 报 文 标识 符 的 入 站 PUBLISH 报 文 
当 作 一 个 新 的 消息 ， 并 忽略 它 的 DUP 标 志 的 值 。 


[MQTT-4.3.3-1] 对 于 QoS 2 的 分 发 协议 ， 发 送 者 


。 必须 给 要 发 送 的 新 应 用 消息 分 配 一 个 未 使 用 的 报 文 标识 符 。 
o MUST send a PUBLISH packet containing this Packet Identifier with QoS=2， 
DUP=0. 
。 发 送 的 PUBLISH 报 文 必 须 包 含 报 文 标识 符 且 报 文 的 QoS 等 于 2,，DUP 等 于 0 。 
o 必须 将 这 个 PUBLISH 报 文 看 作 是 未 确认 的 ， 直 到 从 接收 者 那 收 到 对 应 的 PUBREC 
报 文 。4.4 节 有 一 个 关于 未 确认 消息 的 讨论 。 
o 收 到 PUBREC 报 文 后 必须 发 送 一 个 PUBREL 报 文 。PUBREL 报 文 必 须 包 含 与 原始 
PUBLISH 报 文 相 同 的 报 文 标识 符 。 
o 必须 将 这 个 PUBREL 报 文 看 作 是 未 确认 的 ， 直 到 从 接收 者 那 收 到 对 应 的 PUBCOMP 
报 文 。 
o 一 旦 发 送 了 对 应 的 PUBREL 报 文 就 不 能 重 发 这 个 PUBLISH 报 文 。 


[MQTT-4.3.3-2] 对 于 QoS 2 的 分 发 协议 ， 接 收 者 


。 响应 的 PUBREC 报 文 必须 包含 报 文 标识 符 ， 这 个 标识 符 来 自 接收 到 的 、 已 经 接受 所 有 权 
的 PUBLISH 报 文 。 
在 收 到 对 应 的 PUBREL 报 文 之 前 ， 接 收 者 必须 发 送 PUBREC 报 文 确认 任何 后 续 的 具有 相 
同 标识 符 的 PUBLISH 报 文 。 在 这 种 情况 下 ， 它 不 能 重复 分 发 消息 给 任何 后 续 的 接收 者 。 
响应 PUBREL 报 文 的 PUBCOMP 报 文 必须 包含 与 PUBREL 报 文 相同 的 标识 符 。 
o 发 送 PUBCOMP 报 文 之 后 ， 接 收 者 必须 将 包含 相同 报 文 标识 符 的 任何 后 续 PUBLISH 
报 文 当 作 一 个 新 的 发 布 。 


项 目 主页 
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